social-intelligence

# Social Intelligence with x402 APIs Access Reddit through x402-protected endpoints. ## Setup See [rules/getting-started.md](rules/getting-started.md) for installation and wallet setup. ## Quick Reference | Task | Endpoint | Price | Description | |------|----------|-------|-------------| | Search Reddit | `https://stableenrich.dev/api/reddit/search` | $0.02 | Search Reddit posts | | Get comments | `https://stableenrich.dev/api/reddit/post-comments` | $0.02 | Comments on a post | See [rules/rate-limits.md](rules/rate-limits.md) for usage guidance. ## Reddit ### Search Posts Search Reddit for posts: ```mcp agentcash.fetch( url="https://stableenrich.dev/api/reddit/search", method="POST", body={ "query": "best programming languages 2024" } ) ``` **Parameters:** - `query` - Search terms (required). Scope to a subreddit with Reddit's `subreddit:` operator inside the query (there is no separate subreddit field) - `sort` - relevance, new, top, comment_count (default: relevance) - `timeframe` - all, day, week, month, year (default: all) - `maxResults` - Maximum results, 1-25 (default: 10) - `after` - Pagination cursor from a previous response **Returns:** - Post title and content - Author and subreddit - Upvotes and comment count - Post URL ### Search in Subreddit ```mcp agentcash.fetch( url="https://stableenrich.dev/api/reddit/search", method="POST", body={ "query": "typescript vs javascript subreddit:programming", "sort": "top", "timeframe": "year" } ) ``` ### Get Post Comments Get comments from a Reddit post: ```mcp agentcash.fetch( url="https://stableenrich.dev/api/reddit/post-comments", method="POST", body={ "url": "https://reddit.com/r/programming/comments/abc123/..." } ) ``` **Parameters:** - `url` - Full Reddit post URL (required) - `cursor` - Pagination cursor for more comments **Returns:** - Post details - Comment text and author - Comment scores - Comment timestamps - `hasMore` / `cursor` for pagination ## Workflows ### Standard - [ ] (Optional) Check balance: `agentcash.get_balance` - [ ] Use `agentcash.discover_api_endpoints(url="https://stableenrich.dev")` to list endpoints - [ ] Use `agentcash.check_endpoint_schema(url="...")` to see expected parameters and pricing - [ ] Call endpoint with `agentcash.fetch` - [ ] Parse and present results ### Brand Monitoring - [ ] (Optional) Check balance: `agentcash.get_balance` - [ ] Search Reddit for discussions - [ ] Summarize sentiment and key mentions ```mcp agentcash.fetch( url="https://stableenrich.dev/api/reddit/search", method="POST", body={"query": "YourBrand", "sort": "new"} ) ``` ### Competitor Research - [ ] Search Reddit for competitor reviews - [ ] Analyze common complaints and praise ```mcp agentcash.fetch( url="https://stableenrich.dev/api/reddit/search", method="POST", body={"query": "competitor name review", "sort": "top", "timeframe": "year"} ) ``` ### Community Sentiment - [ ] Identify relevant subreddit - [ ] Search for discussions on topic - [ ] Get comments from top posts - [ ] Synthesize overall sentiment ```mcp agentcash.fetch( url="https://stableenrich.dev/api/reddit/search", method="POST", body={"query": "new feature name subreddit:relevant_community", "sort": "top"} ) ``` ```mcp agentcash.fetch( url="https://stableenrich.dev/api/reddit/post-comments", method="POST", body={"url": "https://reddit.com/..."} ) ``` ## Response Data ### Reddit Post Fields - `title` - Post title - `selftext` - Post body (for text posts; `selftextTruncated` flags truncation) - `author` - Username - `subreddit` - Subreddit name - `score` - Upvotes minus downvotes - `numComments` - Comment count - `permalink` - Link to post - `createdAt` - Timestamp Search responses also include `after` (pagination cursor) and `searchContext` (query + result count). ### Reddit Comment Fields - `body` - Comment text (`bodyTruncated` flags truncation) - `author` - Username - `score` - Net upvotes - `createdAt` - Timestamp Comments are returned as a flat list; use `hasMore` and `cursor` to page through more. ## Cost Estimation | Task | Calls | Cost | |------|-------|------| | Reddit thread + comments | 2 | $0.04 | | Full monitoring scan | 3-5 | $0.06-0.10 |