user_analysis
Analyze Reddit user activity patterns, posting history, karma statistics, and top subreddits to understand behavior and engagement trends.
Instructions
Analyze a Reddit user's posting history, karma, and activity patterns. Returns posts, comments, and statistics.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| comments_limit | No | Number of recent comments to include (0-100, default: 10) | |
| posts_limit | No | Number of recent posts to include (0-100, default: 10) | |
| time_range | No | Period to analyze: "day", "week", "month", "year", "all". Note: "all" returns newest content, others return top-scored content from that period | |
| top_subreddits_limit | No | Number of most-active subreddits to list (1-50, default: 10) | |
| username | Yes | Reddit username without u/ prefix (e.g., "spez", not "u/spez") |
Input Schema (JSON Schema)
{
"properties": {
"comments_limit": {
"description": "Number of recent comments to include (0-100, default: 10)",
"type": "number"
},
"posts_limit": {
"description": "Number of recent posts to include (0-100, default: 10)",
"type": "number"
},
"time_range": {
"description": "Period to analyze: \"day\", \"week\", \"month\", \"year\", \"all\". Note: \"all\" returns newest content, others return top-scored content from that period",
"enum": [
"day",
"week",
"month",
"year",
"all"
],
"type": "string"
},
"top_subreddits_limit": {
"description": "Number of most-active subreddits to list (1-50, default: 10)",
"type": "number"
},
"username": {
"description": "Reddit username without u/ prefix (e.g., \"spez\", not \"u/spez\")",
"type": "string"
}
},
"required": [
"username"
],
"type": "object"
}
Implementation Reference
- src/tools/index.ts:285-384 (handler)The core handler function implementing the user_analysis tool logic. Fetches user profile, posts, and comments from Reddit API, handles time-based filtering with fallbacks, and processes the data into a summary using ContentProcessor.processUserSummary.async userAnalysis(params: z.infer<typeof userAnalysisSchema>) { // Try to get posts within the specified time range first // If time_range is 'all', use 'new' sort; otherwise use 'top' to respect time filtering const sort = params.time_range === 'all' ? 'new' : 'top'; let posts = null; let comments = null; let usedFallback = false; const user = await this.api.getUser(params.username); // Fetch posts if (params.posts_limit > 0) { posts = await this.api.getUserPosts(params.username, 'submitted', { limit: params.posts_limit, sort, time: params.time_range, }); // If no results with time filter, fallback to getting recent posts if (posts.data.children.length === 0 && params.time_range !== 'all') { usedFallback = true; posts = await this.api.getUserPosts(params.username, 'submitted', { limit: params.posts_limit, sort: 'new', time: 'all', }); } } // Fetch comments if (params.comments_limit > 0) { comments = await this.api.getUserPosts(params.username, 'comments', { limit: params.comments_limit, sort, time: params.time_range, }); // If no results with time filter, fallback to getting recent comments if (comments.data.children.length === 0 && params.time_range !== 'all') { usedFallback = true; comments = await this.api.getUserPosts(params.username, 'comments', { limit: params.comments_limit, sort: 'new', time: 'all', }); } } // Process summary let summary: any; if (posts) { summary = ContentProcessor.processUserSummary(user, posts, { maxTopSubreddits: params.top_subreddits_limit, comments: comments || undefined }); } else { // Fallback when no posts - but still include comments if available summary = { username: user.name, accountAge: 'Unknown', karma: { link: user.link_karma, comment: user.comment_karma, total: user.link_karma + user.comment_karma, }, }; // Add comments even when there are no posts if (comments && comments.data.children.length > 0) { summary.recentComments = comments.data.children.map(child => { const comment = child.data as any; return { id: comment.id, body: comment.body?.substring(0, 200) + (comment.body?.length > 200 ? '...' : ''), score: comment.score, subreddit: comment.subreddit || 'unknown', postTitle: comment.link_title, created: new Date(comment.created_utc * 1000), url: `https://reddit.com${comment.permalink}`, }; }); } } // Add note if we used fallback data if (usedFallback && params.time_range !== 'all') { const timeRangeLabel = { 'hour': 'hour', 'day': 'day', 'week': 'week', 'month': 'month', 'year': 'year' }[params.time_range]; summary.timeRangeNote = `No posts found in the last ${timeRangeLabel}, showing all recent posts instead`; } return summary; }
- src/tools/index.ts:41-47 (schema)Zod schema defining the input parameters for the user_analysis tool, including username and optional limits for posts, comments, time range, and top subreddits.export const userAnalysisSchema = z.object({ username: z.string().describe('Reddit username'), posts_limit: z.number().min(0).max(100).optional().default(10).describe('Default 10, range (0-100). Change ONLY IF user specifies.'), comments_limit: z.number().min(0).max(100).optional().default(10).describe('Default 10, range (0-100). Override ONLY IF user asks.'), time_range: z.enum(['day', 'week', 'month', 'year', 'all']).optional().default('month').describe('Time range for posts/comments (default: month). Note: When set to values other than "all", posts are sorted by top scores within that period. When set to "all", posts are sorted by newest'), top_subreddits_limit: z.number().min(1).max(50).optional().default(10).describe('Default 10, range (1-50). Change ONLY IF user requests.'), });
- src/mcp-server.ts:125-129 (registration)Registration of the user_analysis tool in the MCP server's toolDefinitions array, specifying name, description, input schema, and read-only hint.name: 'user_analysis', description: 'Analyze a Reddit user\'s posting history, karma, and activity patterns. Returns posts, comments, and statistics.', inputSchema: zodToJsonSchema(userAnalysisSchema) as any, readOnlyHint: true },
- src/mcp-server.ts:166-170 (registration)Dispatch logic in the MCP tool call handler that invokes the userAnalysis method with parsed arguments when 'user_analysis' is called.case 'user_analysis': result = await tools.userAnalysis( userAnalysisSchema.parse(args) ); break;