Connects to Reddit's public JSON API. An agent can search posts, browse a subreddit's posts, read a post's top comments, and look up subreddit info — all without authentication for read-only access.
Add to an agent node's tools array with _node_type: "tool-reddit". See Connector Reference — How connectors are used.
Authentication
No credentials are required for read-only access — all requests go to Reddit's public .json endpoints with a fixed User-Agent.
| Field | Required | Description |
|---|---|---|
client_id | No | Reserved for future OAuth support. Currently read but unused by any tool. |
client_secret | No | Reserved for future OAuth support. Currently read but unused by any tool. |
username | No | Reserved for future OAuth support. Currently read but unused by any tool. |
password | No | Reserved for future OAuth support. Currently read but unused by any tool. |
{
"name": "reddit",
"_node_type": "tool-reddit"
}
Tools
reddit_search
Search Reddit posts by keyword. Optionally restrict to a specific subreddit.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query |
subreddit | string | No | Limit search to this subreddit (optional) |
sort | string | No | Sort: relevance, hot, new, top (default relevance) |
limit | number | No | Number of results (default 10) |
Returns: A list of posts separated by blank lines, each as **title**\nu/author in r/subreddit | ↑score | N comments\nhttps://reddit.com<permalink>, or "No posts found.".
reddit_get_posts
Get posts from a Reddit subreddit.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | Subreddit name without r/ prefix |
sort | string | No | Sort: hot, new, top, rising (default hot) |
limit | number | No | Number of posts (default 10) |
Returns: Same post-list format as reddit_search, or "No posts found.".
reddit_get_comments
Get top comments for a Reddit post.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
post_url | string | Yes | Reddit post URL (e.g. https://reddit.com/r/golang/comments/abc123/title/) |
limit | number | No | Number of top comments (default 10) |
Returns: Top-level comments separated by ---, each as **u/author** (↑score):\n<body> (body truncated to 500 characters), or "No comments found.".
reddit_get_subreddit_info
Get information about a Reddit subreddit including subscriber count and description.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | Subreddit name without r/ prefix |
Returns: A formatted block: **r/name** — title\nSubscribers: N | Active: N | NSFW: true/false\n\ndescription.