Skip to main content
Glama
Sign In
dev.socialscrape/socialscrape

dev.socialscrape/socialscrape

Official
by SocialScraper
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Reddit

reddit
Read-onlyIdempotent

Retrieve community posts, comments, details, search results, and video transcripts from a social platform, with paging, caching, and credit-aware calls.

Instructions

Data from Reddit: communities and groups, posts and videos, comments, transcripts.

Pick a resource, then pass its parameters as top-level arguments (extras in params). Each call costs the credits shown below and the result says what was charged and what is left; failures are free. List resources return a cursor: pass it back unchanged for the next page. Pass max_age_days to accept a cached copy for free.

Resources:

  • post(url): Reddit post. 1 credit.

  • post.comments(url): Reddit post comments. 1 credit. Paged.

  • post.transcript(url): Reddit video post transcript. 1 credit (captions); AI transcription 1 credit up to 2 minutes, then 5 per started minute of the whole video. Optional: allow_long_transcription.

  • search(query): Reddit search. 1 credit. Paged. Optional: timeframe.

  • subreddit.details(subreddit|url): Subreddit details. 1 credit.

  • subreddit.posts(subreddit): Subreddit posts. 1 credit. Paged. Optional: timeframe.

  • subreddit.search(subreddit, query): Search within a subreddit. 1 credit. Paged. Optional: timeframe.

Input Schema

NameRequiredDescriptionDefault
urlNoURL of the item the resource is about (profile, post, video, event...). Used by: post, post.comments, post.transcript, subreddit.details
sortNoOrder of results. Changing it restarts the cursor chain. Used by: post.comments, subreddit.posts. Allowed values vary by resource (describe shows them)
queryNoSearch terms. Used by: search, subreddit.search
cursorNoOpaque cursor from the previous page; pass it back unchanged
paramsNoAny other parameter for the chosen resource, by name, e.g. {"start_date": "2026-01-01"}. Optional parameters of each resource are in the tool description; call describe for types and allowed values.
languageNo2-letter language. Captions in another language are skipped for AI transcription in this one; by default whatever Reddit has. Used by: post.transcript
resourceYesWhich Reddit data to fetch. The tool description lists what each needs.
subredditNoSubreddit name without r/. Used by: subreddit.details, subreddit.posts, subreddit.search
timeframeNoOnly posts from this window. Used by: search, subreddit.posts, subreddit.search. Allowed values vary by resource (describe shows them)
max_age_daysNoAccept a cached copy fetched within this many days, for 0 credits (0 to 30).

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.1

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the read-only, idempotent, open-world annotations, the description discloses credit costs per resource, that failures are free, how billing is reported, pagination via cursor, and caching with max_age_days. It also explains nuanced transcript transcription costs, which is valuable behavioral context for an agent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the operational model, then presents a compact resource list with costs and optional parameters. Every sentence contributes to selecting a resource, managing pagination, or understanding costs, with no obvious filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex multi-resource tool with 10 parameters, a nested params object, and no output schema, the description is complete enough to call correctly. It covers resource selection, required and optional parameters, costs, pagination, caching, and result billing feedback.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the schema already documents parameter meanings and resource usage. The description adds useful resource-specific parameter semantics, including which resources are paged, optional timeframe use, allow_long_transcription, and the free cached-copy behavior of max_age_days.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly identifies the tool as a Reddit data gateway and enumerates seven specific resources, each with its own purpose such as posts, comments, transcripts, search, and subreddit data. This is specific enough for an agent to distinguish it from non-Reddit sibling tools like youtube, tiktok, or twitter.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives clear guidance on choosing a resource, passing parameters as top-level arguments, using the cursor for pagination, and using max_age_days for free cached results. However, it does not explicitly compare this tool to sibling tools such as get_post, get_comments, get_transcript, or search, leaving some ambiguity about when to use the Reddit gateway versus those alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools