{
  "schemaVersion": "1.0",
  "item": {
    "slug": "reddit-insights",
    "name": "Reddit Insights",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/dowands/reddit-insights",
    "canonicalUrl": "https://clawhub.ai/dowands/reddit-insights",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/reddit-insights",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-insights",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/reddit-insights"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/reddit-insights",
    "agentPageUrl": "https://openagent3.xyz/skills/reddit-insights/agent",
    "manifestUrl": "https://openagent3.xyz/skills/reddit-insights/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/reddit-insights/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Reddit Insights MCP",
        "body": "Semantic search across millions of Reddit posts. Unlike keyword search, this understands intent and meaning."
      },
      {
        "title": "1. Get API Key (free tier available)",
        "body": "Sign up at https://reddit-insights.com\nGo to Settings → API\nCopy your API key"
      },
      {
        "title": "2. Install MCP Server",
        "body": "For Claude Desktop - add to claude_desktop_config.json:\n\n{\n  \"mcpServers\": {\n    \"reddit-insights\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"reddit-insights-mcp\"],\n      \"env\": {\n        \"REDDIT_INSIGHTS_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n\nFor Clawdbot - add to config/mcporter.json:\n\n{\n  \"mcpServers\": {\n    \"reddit-insights\": {\n      \"command\": \"npx reddit-insights-mcp\",\n      \"env\": {\n        \"REDDIT_INSIGHTS_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n\nVerify installation:\n\nmcporter list reddit-insights"
      },
      {
        "title": "Available Tools",
        "body": "ToolPurposeKey Paramsreddit_searchSemantic search across postsquery (natural language), limit (1-100)reddit_list_subredditsBrowse available subredditspage, limit, searchreddit_get_subredditGet subreddit details + recent postssubreddit (without r/)reddit_get_trendsGet trending topicsfilter (latest/today/week/month), category"
      },
      {
        "title": "Performance Notes",
        "body": "Response time: 12-25 seconds (varies by query complexity)\n\nSimple queries: ~12-15s\nComplex semantic queries: ~17-20s\nHeavy load periods: up to 25s\n\n\nBest results: Specific products, emotional language, comparison questions\nWeaker results: Abstract concepts, non-English queries, generic business terms\nSweet spot: Questions a real person would ask on Reddit"
      },
      {
        "title": "Best Use Cases (Tested)",
        "body": "Use CaseEffectivenessWhyProduct comparisons (A vs B)⭐⭐⭐⭐⭐Reddit loves debatesTool/app recommendations⭐⭐⭐⭐⭐High-intent discussionsSide hustle/money topics⭐⭐⭐⭐⭐Engaged communitiesPain point discovery⭐⭐⭐⭐Emotional posts rank wellHealth questions⭐⭐⭐⭐Active health subredditsTechnical how-to⭐⭐⭐Better to search specific subredditsAbstract market research⭐⭐Too vague for semantic searchNon-English queries⭐Reddit is English-dominant"
      },
      {
        "title": "✅ Excellent Queries (relevance 0.70+)",
        "body": "Product Comparisons (best results!):\n\n\"Notion vs Obsidian for note taking which one should I use\"\n→ Relevance: 0.72-0.81 | Found: Detailed comparison discussions, user experiences\n\n\"why I switched from Salesforce to HubSpot honest experience\"  \n→ Relevance: 0.70-0.73 | Found: Migration stories, feature comparisons\n\nSide Hustle/Money Topics:\n\n\"side hustle ideas that actually make money not scams\"\n→ Relevance: 0.70-0.77 | Found: Real experiences, specific suggestions\n\nNiche App Research:\n\n\"daily horoscope apps which one is accurate and why\"\n→ Relevance: 0.67-0.72 | Found: App recommendations, feature requests"
      },
      {
        "title": "✅ Good Queries (relevance 0.60-0.69)",
        "body": "Pain Point Discovery:\n\n\"I hate my current CRM it is so frustrating\"\n→ Relevance: 0.60-0.64 | Found: Specific CRM complaints, feature wishlists\n\n\"cant sleep at night tried everything what actually works\"\n→ Relevance: 0.60-0.63 | Found: Sleep remedies discussions, medical advice seeking\n\nTool Evaluation:\n\n\"AI tools that actually save time not just hype\"\n→ Relevance: 0.64-0.65 | Found: Real productivity gains, tool recommendations"
      },
      {
        "title": "❌ Weak Queries (avoid these patterns)",
        "body": "Too Abstract:\n\n\"business opportunity growth potential\"\n→ Relevance: 0.52-0.58 | Returns unrelated generic posts\n\nNon-English:\n\n\"学习编程最好的方法\" (Chinese)\n→ Relevance: 0.45-0.51 | Reddit is English-dominant, poor cross-lingual results"
      },
      {
        "title": "Query Formula Cheat Sheet",
        "body": "GoalPatternRelevanceCompare products\"[Product A] vs [Product B] which should I use\"0.70-0.81Find switchers\"why I switched from [A] to [B]\"0.70-0.73Money/hustle topics\"[topic] that actually [works/makes money] not [scam/hype]\"0.70-0.77App recommendations\"[category] apps which one is [accurate/best] and why\"0.67-0.72Pain points\"I hate my current [tool] it is so [frustrating/slow]\"0.60-0.64Solutions seeking\"[problem] tried everything what actually works\"0.60-0.63"
      },
      {
        "title": "Response Fields",
        "body": "Each result includes:\n\ntitle, content - Post text\nsubreddit - Source community\nupvotes, comments - Engagement metrics\nrelevance (0-1) - Semantic match score (0.5+ is good, 0.6+ is strong)\nsentiment - Discussion/Q&A/Story Sharing/Original Content/News\nurl - Direct Reddit link\n\nExample response:\n\n{\n  \"id\": \"1oecf5e\",\n  \"title\": \"Trying to solve the productivity stack problem\",\n  \"content\": \"The perfect productivity app doesn't exist. No single app can do everything well, so we use a stack of apps. But this creates another problem: multi app fragmentation...\",\n  \"subreddit\": \"productivityapps\",\n  \"upvotes\": 1,\n  \"comments\": 0,\n  \"relevance\": 0.631,\n  \"sentiment\": \"Discussion\",\n  \"url\": \"https://reddit.com/r/productivityapps/comments/1oecf5e\"\n}"
      },
      {
        "title": "Tips",
        "body": "Natural language works best - Ask questions like a human would\nInclude context - \"for small business\" or \"as a developer\" improves results\nCombine emotion words - \"frustrated\", \"love\", \"hate\", \"wish\" find stronger opinions\nFilter by engagement - High upvotes/comments = validated pain points\nCheck multiple subreddits - Same topic discussed differently in r/startups vs r/smallbusiness"
      },
      {
        "title": "Example Workflows",
        "body": "Find SaaS opportunity:\n\nreddit_search: \"frustrated with project management tools for remote teams\"\nFilter results with high engagement\nIdentify recurring complaints → product opportunity\n\nValidate idea:\n\nreddit_search: \"[your product category] recommendations\"\nSee what alternatives people mention\nNote gaps in existing solutions\n\nContent research:\n\nreddit_get_subreddit: Get posts from target community\nreddit_search: Find specific questions/discussions\nCreate content answering real user questions"
      }
    ],
    "body": "Reddit Insights MCP\n\nSemantic search across millions of Reddit posts. Unlike keyword search, this understands intent and meaning.\n\nSetup\n1. Get API Key (free tier available)\nSign up at https://reddit-insights.com\nGo to Settings → API\nCopy your API key\n2. Install MCP Server\n\nFor Claude Desktop - add to claude_desktop_config.json:\n\n{\n  \"mcpServers\": {\n    \"reddit-insights\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"reddit-insights-mcp\"],\n      \"env\": {\n        \"REDDIT_INSIGHTS_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n\n\nFor Clawdbot - add to config/mcporter.json:\n\n{\n  \"mcpServers\": {\n    \"reddit-insights\": {\n      \"command\": \"npx reddit-insights-mcp\",\n      \"env\": {\n        \"REDDIT_INSIGHTS_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n\n\nVerify installation:\n\nmcporter list reddit-insights\n\nAvailable Tools\nTool\tPurpose\tKey Params\nreddit_search\tSemantic search across posts\tquery (natural language), limit (1-100)\nreddit_list_subreddits\tBrowse available subreddits\tpage, limit, search\nreddit_get_subreddit\tGet subreddit details + recent posts\tsubreddit (without r/)\nreddit_get_trends\tGet trending topics\tfilter (latest/today/week/month), category\nPerformance Notes\nResponse time: 12-25 seconds (varies by query complexity)\nSimple queries: ~12-15s\nComplex semantic queries: ~17-20s\nHeavy load periods: up to 25s\nBest results: Specific products, emotional language, comparison questions\nWeaker results: Abstract concepts, non-English queries, generic business terms\nSweet spot: Questions a real person would ask on Reddit\nBest Use Cases (Tested)\nUse Case\tEffectiveness\tWhy\nProduct comparisons (A vs B)\t⭐⭐⭐⭐⭐\tReddit loves debates\nTool/app recommendations\t⭐⭐⭐⭐⭐\tHigh-intent discussions\nSide hustle/money topics\t⭐⭐⭐⭐⭐\tEngaged communities\nPain point discovery\t⭐⭐⭐⭐\tEmotional posts rank well\nHealth questions\t⭐⭐⭐⭐\tActive health subreddits\nTechnical how-to\t⭐⭐⭐\tBetter to search specific subreddits\nAbstract market research\t⭐⭐\tToo vague for semantic search\nNon-English queries\t⭐\tReddit is English-dominant\nQuery Strategies (Tested with Real Data)\n✅ Excellent Queries (relevance 0.70+)\n\nProduct Comparisons (best results!):\n\n\"Notion vs Obsidian for note taking which one should I use\"\n→ Relevance: 0.72-0.81 | Found: Detailed comparison discussions, user experiences\n\n\"why I switched from Salesforce to HubSpot honest experience\"  \n→ Relevance: 0.70-0.73 | Found: Migration stories, feature comparisons\n\n\nSide Hustle/Money Topics:\n\n\"side hustle ideas that actually make money not scams\"\n→ Relevance: 0.70-0.77 | Found: Real experiences, specific suggestions\n\n\nNiche App Research:\n\n\"daily horoscope apps which one is accurate and why\"\n→ Relevance: 0.67-0.72 | Found: App recommendations, feature requests\n\n✅ Good Queries (relevance 0.60-0.69)\n\nPain Point Discovery:\n\n\"I hate my current CRM it is so frustrating\"\n→ Relevance: 0.60-0.64 | Found: Specific CRM complaints, feature wishlists\n\n\"cant sleep at night tried everything what actually works\"\n→ Relevance: 0.60-0.63 | Found: Sleep remedies discussions, medical advice seeking\n\n\nTool Evaluation:\n\n\"AI tools that actually save time not just hype\"\n→ Relevance: 0.64-0.65 | Found: Real productivity gains, tool recommendations\n\n❌ Weak Queries (avoid these patterns)\n\nToo Abstract:\n\n\"business opportunity growth potential\"\n→ Relevance: 0.52-0.58 | Returns unrelated generic posts\n\n\nNon-English:\n\n\"学习编程最好的方法\" (Chinese)\n→ Relevance: 0.45-0.51 | Reddit is English-dominant, poor cross-lingual results\n\nQuery Formula Cheat Sheet\nGoal\tPattern\tRelevance\nCompare products\t\"[Product A] vs [Product B] which should I use\"\t0.70-0.81\nFind switchers\t\"why I switched from [A] to [B]\"\t0.70-0.73\nMoney/hustle topics\t\"[topic] that actually [works/makes money] not [scam/hype]\"\t0.70-0.77\nApp recommendations\t\"[category] apps which one is [accurate/best] and why\"\t0.67-0.72\nPain points\t\"I hate my current [tool] it is so [frustrating/slow]\"\t0.60-0.64\nSolutions seeking\t\"[problem] tried everything what actually works\"\t0.60-0.63\nResponse Fields\n\nEach result includes:\n\ntitle, content - Post text\nsubreddit - Source community\nupvotes, comments - Engagement metrics\nrelevance (0-1) - Semantic match score (0.5+ is good, 0.6+ is strong)\nsentiment - Discussion/Q&A/Story Sharing/Original Content/News\nurl - Direct Reddit link\n\nExample response:\n\n{\n  \"id\": \"1oecf5e\",\n  \"title\": \"Trying to solve the productivity stack problem\",\n  \"content\": \"The perfect productivity app doesn't exist. No single app can do everything well, so we use a stack of apps. But this creates another problem: multi app fragmentation...\",\n  \"subreddit\": \"productivityapps\",\n  \"upvotes\": 1,\n  \"comments\": 0,\n  \"relevance\": 0.631,\n  \"sentiment\": \"Discussion\",\n  \"url\": \"https://reddit.com/r/productivityapps/comments/1oecf5e\"\n}\n\nTips\nNatural language works best - Ask questions like a human would\nInclude context - \"for small business\" or \"as a developer\" improves results\nCombine emotion words - \"frustrated\", \"love\", \"hate\", \"wish\" find stronger opinions\nFilter by engagement - High upvotes/comments = validated pain points\nCheck multiple subreddits - Same topic discussed differently in r/startups vs r/smallbusiness\nExample Workflows\n\nFind SaaS opportunity:\n\nreddit_search: \"frustrated with project management tools for remote teams\"\nFilter results with high engagement\nIdentify recurring complaints → product opportunity\n\nValidate idea:\n\nreddit_search: \"[your product category] recommendations\"\nSee what alternatives people mention\nNote gaps in existing solutions\n\nContent research:\n\nreddit_get_subreddit: Get posts from target community\nreddit_search: Find specific questions/discussions\nCreate content answering real user questions"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dowands/reddit-insights",
    "publisherUrl": "https://clawhub.ai/dowands/reddit-insights",
    "owner": "dowands",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/reddit-insights",
    "downloadUrl": "https://openagent3.xyz/downloads/reddit-insights",
    "agentUrl": "https://openagent3.xyz/skills/reddit-insights/agent",
    "manifestUrl": "https://openagent3.xyz/skills/reddit-insights/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/reddit-insights/agent.md"
  }
}