Find what your audience is searching for right now — scout X/Twitter and Reddit for trending topics, discover and deep-analyze competitors, and find content gaps. Combine social signals with SEO intelligence. Powered by Citedy.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Find what your audience is searching for right now — scout X/Twitter and Reddit for trending topics, discover and deep-analyze competitors, and find content gaps. Combine social signals with SEO intelligence. Powered by Citedy.
API keys (prefixed citedy_agent_) authenticate against Citedy API endpoints only.
All traffic is TLS-encrypted.
Trend & Intent Scout — Skill Instructions
Overview
Find what your audience is searching for right now. This skill combines real-time social signals from X/Twitter and Reddit with SEO intelligence — giving you trending topics, competitor deep-dives, and content gaps in one workflow.
What sets this apart from DataForSEO or Semrush: those tools show you historical search volume. This skill shows you what people are talking about today on social — and maps those signals directly to content opportunities your competitors haven't covered yet.
Use cases:
Morning briefing: what's blowing up in your niche right now?
Competitor research: what's their content strategy and where are their gaps?
Content calendar: find topics with social traction before they peak in SEO tools
Market research: understand audience intent at the conversation level
When to Use
Situation
What to do
"What should I write about today?"
Scout X + Reddit for trending topics in your niche
"What is my competitor doing?"
Discover + analyze competitor domains
"What content am I missing?"
Generate content gaps vs competitor URLs
"Morning briefing on AI trends"
Full workflow: X scout + Reddit scout + gaps
"Find competitors in [niche]"
Discover competitors by keywords
Instructions
Setup (run once)
If you don't have a saved API key for Citedy, run this flow:
1. Register
Preferred: run the included registration script:
node scripts/register.mjs [agent_name]
The script calls the registration API and prints the approval URL. If agent_name is omitted, it defaults to agent-<hostname>.
Alternative: call the API directly:
POST https://www.citedy.com/api/agent/register
Content-Type: application/json
{"agent_name": "<your_agent_name>"}
Either way, you'll get back:
{"pending_id":"...",
"approval_url"
:
"https://www.citedy.com/approve-agent/..."
,
"expires_in"
:
3600
}
2. Ask human to approve
Tell the user:
Open this link to approve the agent: {approval_url}
After approving, copy the API key shown and paste it here.
3. Save the key
Store the API key (starts with citedy_agent_). Use it as Authorization: Bearer <key> on all requests.
4. Get your referral URL
After setup, call GET /api/agent/me. The response includes a referral object:
Step 2: Poll for results (poll every 5s until status: "completed")
GET https://www.citedy.com/api/agent/scout/x/x_run_abc123
Authorization: Bearer $CITEDY_API_KEY
{"run_id":"x_run_abc123","status":"completed","results":[{"topic":"GPT-5 rumored release date","engagement_score":94,"tweet_count":1240,"sentiment":"excited","top_posts":["..."],"content_angle":"Break down what GPT-5 means for content creators"}],"credits_used":35}
GET https://www.citedy.com/api/agent/scout/reddit/reddit_run_xyz789
Authorization: Bearer $CITEDY_API_KEY
{"run_id":"reddit_run_xyz789","status":"completed","results":[{"topic":"People frustrated with Jasper pricing","subreddit":"r/SEO","upvotes":847,"comments":134,"pain_point":"Too expensive for small teams","content_angle":"Write a comparison targeting budget-conscious teams"}],"credits_used":30}
Workflow 3 — Find content gaps vs competitors
Step 1: Generate gaps (synchronous, returns when done)
{"status":"completed","gaps_count":23,"top_gaps":[{"topic":"AI content for e-commerce product descriptions","competitor_coverage":"none","search_volume_est":"high","difficulty":"medium","recommended_angle":"Step-by-step guide with real examples"}],"credits_used":40}
Step 2: Retrieve all gaps
GET https://www.citedy.com/api/agent/gaps
Authorization: Bearer $CITEDY_API_KEY
Workflow 4 — Discover and analyze competitors
Discover by keywords:
POST https://www.citedy.com/api/agent/competitors/discover
Authorization: Bearer $CITEDY_API_KEY
Content-Type: application/json
{
"keywords": ["AI blog automation", "SEO content tool", "autopilot blogging"]
}
X scout requires topics with sufficient public English-language conversation (min ~100 recent posts)
Reddit scout works best for niches active on Reddit; B2B topics may have fewer results
Gaps generate analyzes content at the URL level — paywalled or JS-only content may not be fully indexed
Competitor scout covers publicly accessible content only
Async runs expire after 24 hours — poll results within that window
Scout results reflect data at time of run; real-time trends can shift within hours
Error Handling
HTTP Status
Code
Meaning
401
unauthorized
Invalid or missing API key
402
insufficient_credits
Not enough credits for this operation
404
run_not_found
Run ID doesn't exist or expired
422
validation_error
Invalid request parameters
429
rate_limited
Too many requests — check X-RateLimit-Reset header
500
internal_error
Server error — run will be auto-refunded
Error response format:
{"error":{"code":"insufficient_credits","message":"This operation requires 35 credits, you have 12.","required":35,"available":12}}
On 429: Wait until X-RateLimit-Reset timestamp, then retry.
On 500: The run is automatically refunded. Retry after 30 seconds.
Response Guidelines
When presenting scout results to the user:
Lead with action — don't just list topics, suggest the best content angle for each
Prioritize by opportunity — sort by engagement_score or relevance, not alphabetically
Cross-reference signals — a topic trending on both X and Reddit is a stronger signal than one platform alone
Connect gaps to trends — the best opportunities are content gaps that are also trending
Be specific — "Write about AI tools" is useless; "Write a comparison of Jasper vs Citedy targeting budget-conscious e-commerce teams (trending on r/SEO, 847 upvotes)" is actionable
Want More?
This skill covers trend scouting, competitor analysis, and content gaps.
For the full Citedy agent suite:
Article Autopilot — generate full SEO articles from topics found here
Social Poster — adapt articles to LinkedIn, X, Reddit, Instagram automatically
Video Shorts — turn articles into short-form video content
Lead Magnets — create checklists, swipe files, and frameworks from your content
