keyapi-reddit-user-analysis

Discover and analyze Reddit users and subreddits — from user profiles and community activity to subreddit governance, search intelligence, and trending topic discovery.

This skill provides comprehensive Reddit user and community intelligence using the KeyAPI MCP service. It enables retrieval of user profiles, active subreddit memberships, public trophies, subreddit rules and style, post channels, settings, mute status, and powerful search capabilities including typeahead suggestions, dynamic multi-type search, and trending search topics — all through a unified, cache-first workflow.

Use this skill when you need to:

• Retrieve a Reddit user's public profile, karma breakdown, and account metadata
• Identify the subreddits a user is most active in
• Audit a user's public trophies and achievement history
• Research subreddit rules, style guidelines, and community settings
• Discover post channels and content categories within a subreddit
• Search Reddit for posts, communities, users, comments, and media
• Monitor trending search topics across the platform

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Prerequisites

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

MCP Server Configuration

All tool calls in this skill target the KeyAPI Reddit MCP server:

Server URL : https://mcp.keyapi.ai/reddit/mcp
Auth Header: Authorization: Bearer $KEYAPI_TOKEN

Setup (one-time):

# 1. Install dependencies
npm install

# 2. Set your API token (get one free at https://keyapi.ai/)
export KEYAPI_TOKEN=your_token_here

# 3. List all available tools to verify the connection
node scripts/run.js --platform reddit --list-tools

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Analysis Scenarios

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Workflow

Step 1 — Identify Analysis Targets and Select Nodes

Clarify the research objective and map it to one or more nodes. Typical entry points:

• User research: Use fetch_reddit_app_user_profile → fetch_users_active_subreddits → fetch_user_public_trophies.
• Subreddit audit: Use fetch_reddit_app_subreddit_info → fetch_reddit_app_subreddit_rules_and_style_info → fetch_reddit_app_subreddit_post_channels.
• Search workflow: Use fetch_reddit_app_search_typeahead_suggestions to refine query, then fetch_reddit_app_dynamic_search_results for full results.
• Trend monitoring: Use fetch_reddit_app_trending_searches (no parameters required).

Subreddit Identifier: subreddit_name vs. subreddit_id

Two different identifiers are used across subreddit endpoints:

• subreddit_name — the display name (e.g., technology, worldnews). Used by fetch_reddit_app_subreddit_rules_and_style_info, fetch_reddit_app_subreddit_post_channels, fetch_reddit_app_subreddit_info.
• subreddit_id — the internal ID with a t5_ prefix (e.g., t5_2qh0u). Required by fetch_reddit_app_subreddit_settings, check_if_subreddit_is_muted, fetch_reddit_app_community_highlights.

Call fetch_reddit_app_subreddit_info with subreddit_name first to obtain the subreddit_id when needed.

fetch_reddit_app_trending_searches

This endpoint requires no parameters. Call it directly to retrieve the current list of trending search topics across Reddit.

need_format Parameter

Most endpoints accept an optional need_format boolean. Set to true for sanitized/cleaned response data. Defaults to false.

Step 2 — Retrieve API Schema

Before calling any node, inspect its input schema to confirm required parameters and available options:

node scripts/run.js --platform reddit --schema \x3Ctool_name>

# Examples
node scripts/run.js --platform reddit --schema fetch_reddit_app_user_profile
node scripts/run.js --platform reddit --schema fetch_reddit_app_dynamic_search_results

Step 3 — Call APIs and Cache Results Locally

Execute tool calls and persist responses to the local cache to avoid redundant API calls.

Calling a tool:

# Single call with pretty output
node scripts/run.js --platform reddit --tool \x3Ctool_name> \
  --params '\x3Cjson_args>' --pretty

# Force fresh data, skip cache
node scripts/run.js --platform reddit --tool \x3Ctool_name> \
  --params '\x3Cjson_args>' --no-cache --pretty

Example — get user profile:

node scripts/run.js --platform reddit --tool fetch_reddit_app_user_profile \
  --params '{"username":"spez"}' --pretty

Example — get user's active subreddits:

node scripts/run.js --platform reddit --tool fetch_users_active_subreddits \
  --params '{"username":"spez"}' --pretty

Example — get subreddit post channels (with sort and range):

node scripts/run.js --platform reddit --tool fetch_reddit_app_subreddit_post_channels \
  --params '{"subreddit_name":"technology","sort":"HOT","range":"DAY"}' --pretty

Example — get subreddit settings (requires t5_ prefixed subreddit_id):

node scripts/run.js --platform reddit --tool fetch_reddit_app_subreddit_settings \
  --params '{"subreddit_id":"t5_2qh0u"}' --pretty

Example — get subreddit info:

node scripts/run.js --platform reddit --tool fetch_reddit_app_subreddit_info \
  --params '{"subreddit_name":"technology"}' --pretty

Example — dynamic search for posts:

node scripts/run.js --platform reddit --tool fetch_reddit_app_dynamic_search_results \
  --params '{"query":"AI regulation","search_type":"post","sort":"RELEVANCE","time_range":"month"}' --pretty

Example — get trending searches (no params):

node scripts/run.js --platform reddit --tool fetch_reddit_app_trending_searches \
  --params '{}' --pretty

fetch_reddit_app_dynamic_search_results options:

Pagination:

Cache directory structure:

.keyapi-cache/
└── YYYY-MM-DD/
    ├── fetch_reddit_app_user_profile/
    │   └── {params_hash}.json
    ├── fetch_users_active_subreddits/
    │   └── {params_hash}.json
    ├── fetch_user_public_trophies/
    │   └── {params_hash}.json
    ├── fetch_reddit_app_subreddit_rules_and_style_info/
    │   └── {params_hash}.json
    ├── fetch_reddit_app_subreddit_post_channels/
    │   └── {params_hash}.json
    ├── fetch_reddit_app_subreddit_info/
    │   └── {params_hash}.json
    ├── fetch_reddit_app_subreddit_settings/
    │   └── {params_hash}.json
    ├── check_if_subreddit_is_muted/
    │   └── {params_hash}.json
    ├── fetch_reddit_app_search_typeahead_suggestions/
    │   └── {params_hash}.json
    ├── fetch_reddit_app_dynamic_search_results/
    │   └── {params_hash}.json
    └── fetch_reddit_app_trending_searches/
        └── {params_hash}.json

Cache-first policy:

Before every API call, check whether a cached result already exists for the given parameters. If a valid cache file exists, load from disk and skip the API call.

Step 4 — Synthesize and Report Findings

After collecting all API responses, produce a structured user and community intelligence report:

For user analysis:

1. User Profile — Username, karma breakdown (post/comment), account age, verification status, premium status.
2. Community Footprint — Most active subreddits, participation frequency, community diversity.
3. Achievement History — Public trophies, milestone dates, recognition type.
4. Behavioral Signals — Activity patterns, community focus areas, engagement style.

For subreddit research:

1. Community Overview — Name, subscriber count, description, creation date, NSFW status.
2. Governance Structure — Rules, posting requirements, moderation policies, style guidelines.
3. Content Architecture — Post channels, content categories, flair taxonomy.
4. Settings Profile — Posting rules, badge configuration, moderation settings.

For search intelligence:

1. Search Results — Matched posts, communities, users, or comments with relevance scores.
2. Trending Topics — Current platform-wide trending searches and emerging discussions.
3. Discovery Signals — Subreddit recommendations, user suggestions from typeahead.

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Common Rules

author: KeyAPI license: MIT repository: https://github.com/EchoSell/keyapi-skills

Error Handling