Spiral gives your agent every tool with one account. Browse the tools →

Hermes · Social Media

How to Use Reddit Post in Hermes

Fetch one public Reddit post’s title, body, subreddit, score, upvote ratio, comment count, timestamps, and flags. Use it to inspect a known post or enrich a search result without retrieving comments.

Prompts to try with Reddit Post in Hermes

Copy an example into Hermes, or ask in your own words.

Every Monday, use Reddit post details for https://www.reddit.com/r/reddit/comments/12qwagm/an_update_regarding_reddits_api/. Alert me only if the original post’s body changes.

Reddit PostHermes
Try asking
  • Once a month, use Reddit post details for https://www.reddit.com/r/modnews/comments/12kxfd4/mobile_moderation_on_reddit/. Compare the body with the previous check and report any revised feature descriptions.

  • Each morning, use Reddit post details on the r/reddit announcement URLs in my watchlist. Flag posts whose comment count has increased by at least 100 since the previous check.

  • Each afternoon, use Reddit post details on the r/modnews announcement URLs I am following. Report any change in whether a post is locked or archived.

  • Every Friday, use Reddit post details for https://www.reddit.com/r/reddit/comments/12qwagm/an_update_regarding_reddits_api/ and https://www.reddit.com/r/modnews/comments/12kxfd4/mobile_moderation_on_reddit/. Report only changes in their text or discussion status since last week.

How to set up Reddit Post in Hermes

Pick the way that suits you. Each takes about two minutes.

Use the Spiral skill

  1. Send Hermes this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Reddit Post

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "scrapecreators",
        "model": "scrapecreators/reddit-post",
        "input": {
          "url": "https://www.reddit.com/r/webscraping/comments/1q6pxwn/just_started_web_scraping_is_this_a_good_start/"
        }
      }'

Then paste one of the prompts above: Hermes finds Reddit Post on Spiral, shows the price and runs it.

Reddit Post providers and prices

Spiral runs Reddit Post through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Reddit · Post
scrapecreators/reddit-post

What can you do with Reddit Post in Hermes?

Catch revisions to selected public Reddit announcements before they leave an outdated brief in circulation. A scheduled agent can also recheck discussion counts and status on supplied company-post links and flag changes for review.

Brief an official announcement

Turn a known public company announcement into a short brief using its title and body, with the Reddit permalink for reference.

Add engagement context to search results

Fetch the upvote ratio for selected Reddit search hits before comparing posts about a product or market topic.

Compare selected product discussions

Compare the original text, score, and comment count of supplied product-discussion links to decide which posts deserve a closer read.

Detect announcement edits

Compare successive copies of an official announcement’s body and flag changed dates, promises, or feature descriptions.

Prioritize public discussion reviews

Recheck selected business-related posts and flag increases in comment count for a human reviewer to investigate.

Check discussion status

Inspect archived and locked flags on a known announcement before recommending that a community manager join the discussion.

Questions about Reddit Post in Hermes

Can Hermes use Reddit Post?

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Reddit Post like any built-in tool.

How much does Reddit Post cost in Hermes?

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

Do I need a ScrapeCreators account to use Reddit Post in Hermes?

No. Spiral runs Reddit Post on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Reddit Post in Hermes?

About two minutes: add the server and sign in, then check it.

Does Hermes wait while Reddit Post runs?

Reddit Post runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

Does this return the whole discussion?

It returns one post without comment text. The response includes the comment count, so you can assess discussion volume without reading the replies.

How fresh is the data?

ScrapeCreators says cache misses fetch live public data from Reddit, while cache hits return a cached copy. That distinction matters when comparing scores or comment counts across checks.

Are vote totals an exact measure of public opinion?

Reddit warns that vote-based polls are unreliable because of vote fuzzing. Use the returned score and upvote ratio as engagement signals rather than a precise opinion survey.

Does public Reddit data include private communities?

Reddit’s Public Content Policy excludes posts and comments in private or quarantined communities from the public data it licenses or makes publicly available. This endpoint is documented for public posts.

Can a post’s text change after publication?

Yes. Reddit allows text-post bodies to be edited after submission, so an announcement’s current body can differ from an earlier copy.

Get started

Start using Reddit Post in Hermes

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Hermes:

Set up Hermes

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options