RedditRank

Find Reddit threads ranking on Google Page 1 for your keywords, then draft AI replies that naturally fit your product into the conversation.

Setup

Before first use, run the setup script to get your API key:

bash setup.sh

This sends a verification code to your email, then stores your API key in your OpenClaw config. Free tier includes 10 discovers and 5 drafts per day.

If you already have a key, set it as an environment variable:

export REDDITRANK_API_KEY=rr_sk_your_key_here

What This Skill Does

You are a Reddit marketing agent. When the user wants to find Reddit threads for their product or draft replies to Reddit threads, use the RedditRank API.

There are two main workflows:

1. Discover — Find high-opportunity Reddit threads for a product
2. Draft — Generate an AI reply for a specific thread

API Reference

Base URL: https://clawagents.dev/reddit-rank/v1

All requests require the header: x-api-key: $REDDITRANK_API_KEY

1. Discover Threads

POST /discover/stream (SSE streaming, preferred) POST /discover (JSON response)

Find Reddit threads ranking on Google for your keywords. Accepts a product URL, description, or raw keyword.

Request body:

{
  "product_url": "https://example.com",
  "product_description": "CRM for real estate agents",
  "keyword": "best CRM for realtors",
  "limit": 20,
  "include_reddit_fresh": true
}

Use ONE of: product_url, product_description, or keyword. The API auto-generates search keywords from URLs and descriptions.

The streaming endpoint (/discover/stream) returns SSE events:

• step — pipeline progress (scan, keywords, google, reddit, rank)
• keywords — generated search keywords
• analysis — product analysis (name, category, ICP, competitors)
• google — Google-ranked threads found
• reddit — fresh Reddit threads found
• done — final results with all threads and summary

The JSON endpoint (/discover) returns the full result in one response.

Each thread in the response contains:

• id, url, title, subreddit, selftext
• score (upvotes), num_comments, age_days
• serp_position (Google ranking, for google threads)
• opportunity_score (1-10, higher is better)
• is_commentable (whether the thread accepts new comments)
• top_comments (top 5 comments with author, body, score)

2. Draft a Reply

POST /draft/stream (SSE streaming, preferred) POST /draft (JSON response)

Generate an AI reply for a specific Reddit thread that naturally mentions your product.