redditapis-mcp 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.1.4
+- New tool `reddit_deep_comment_search`. Where `reddit_search_comments` returns
+  the parent posts (Reddit's comment search never hands back the comment), this
+  returns the ACTUAL matching comments with body, score, author, a comment-deep
+  permalink, and the parent post. It fetches each matching post's comment tree
+  and filters the bodies. Premium call (`limit` = parent posts to expand, 1-10).
+  Best-effort: a deleted or deeply-nested comment may be missed. Also cross-links
+  the two tools in their descriptions.
+
+## 0.1.3
+- `reddit_search_comments` description no longer overpromises. It previously
+  claimed to "Return matching comments with author, body, score" and to find
+  "opinions/answers buried in threads", but the endpoint returns PARENT POSTS,
+  not comment objects: Reddit's comment search is a MODE that matches comment
+  text and hands back the t3 posts, and does not expose which comment matched or
+  its body. The openapi spec already said this; the MCP tool description and the
+  README table had drifted and still promised comment bodies/scores the response
+  never contained. A customer relied on the old text and reported it as a bug.
+  The description now states the real behaviour. No API surface change.
+
 ## 0.1.2
 - `reddit_search` and `reddit_search_comments` now describe the `t` time window
   accurately. Unlike a subreddit listing, search applies `t` to the `relevance`

package/README.md

@@ -47,7 +47,7 @@ authenticated surface and are intentionally not exposed here.
 | `reddit_search` | `GET /api/reddit/search` | Search posts across Reddit or one subreddit |
 | `reddit_post_comments` | `GET /api/reddit/comments` | A post + its comment tree, by permalink |
 | `reddit_search_communities` | `GET /api/reddit/search/communities` | Find subreddits by name/topic |
-| `reddit_search_comments` | `GET /api/reddit/search/comments` | Search comments (not posts) |
+| `reddit_search_comments` | `GET /api/reddit/search/comments` | Search by comment text; returns the parent posts (Reddit limitation) |
 | `reddit_search_media` | `GET /api/reddit/search/media` | Search image/video/gif posts |
 | `reddit_search_users` | `GET /api/reddit/search/users` | Find redditors by name |
 | `reddit_subreddit_top` | `GET /api/reddit/sub/{name}/top` | Top posts of a subreddit for a time window |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redditapis-mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Official MCP server for redditapis.com, the Reddit API (subreddit listings, post + comment + community + user + media search, comment trees, top posts, user profiles) as native tools for Claude, Cursor, and any MCP client.",
   "repository": {
     "type": "git",
@@ -24,8 +24,7 @@
   "scripts": {
     "start": "node src/index.js",
     "check": "node --check src/index.js && node --check src/tools.js",
-    "test": "node test/tools.test.mjs",
-    "prepublishOnly": "python3 $HOME/.claude/scripts/tenant-isolation-scan.py --tenant redditapis --npm-publish-surface ."
+    "test": "node test/tools.test.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",

package/src/tools.js

@@ -119,9 +119,24 @@ export const TOOLS = [
     name: "reddit_search_comments",
     path: "/api/reddit/search/comments",
     description:
-      "Search Reddit COMMENTS (not posts) by keyword across Reddit. Returns matching comments with author, body, score, subreddit, and the parent post link. Use to find first-hand opinions/answers buried in threads. Example: q='best mechanical keyboard' sort='top'.",
+      "Search Reddit by COMMENT text. Reddit's comment search matches your keyword against comment bodies but returns the PARENT POSTS, not the individual comments, so each result is a post whose discussion mentions your query, carrying that post's title, selftext, score, and comment count. Use it to surface threads where a topic comes up in the replies that plain post-title search would miss. Reddit does not expose which specific comment matched or its text, so this returns posts, not comment bodies. For the actual comment bodies, use reddit_deep_comment_search. Example: q='best mechanical keyboard' sort='top'.",
     shape: { ...QUERY, ...SORT_SEARCH, ...TIME_SEARCH, ...AFTER, ...NSFW, ...LIMIT },
   },
+  {
+    name: "reddit_deep_comment_search",
+    path: "/api/reddit/search/comments/deep",
+    description:
+      "Genuine comment search: returns the ACTUAL comments whose body matches your keyword, with body, score, author, a comment-deep permalink, and the parent post. Unlike reddit_search_comments (which returns the parent posts, a Reddit limitation), this fetches each matching post's comment tree and filters the comment bodies for you, so you get first-hand opinions and answers directly. Premium call (it fans out into several reads): `limit` sets how many parent POSTS to expand, 1-10 (default 5), not how many comments come back. Best-effort: a deleted or deeply-nested comment may be missed (a truncated flag says when a tree was too deep). Example: q='best mechanical keyboard' sort='top'.",
+    shape: {
+      ...QUERY,
+      ...SORT_SEARCH,
+      ...TIME_SEARCH,
+      ...NSFW,
+      limit: z.number().int().min(1).max(10).optional().describe(
+        "Number of parent POSTS to expand into their comment trees (1-10, default 5). Each is one upstream read, so higher = deeper coverage but slower and more expensive.",
+      ),
+    },
+  },
   {
     name: "reddit_search_media",
     path: "/api/reddit/search/media",