citedy-trend-scout
starsforks
How to install citedy-trend-scout?
citedy/citedy-seo-agent/citedy-trend-scout
$npx -y skills add citedy/citedy-seo-agent --skill citedy-trend-scoutFind 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.
SKILL.md
| 1 | # Trend & Intent Scout — Skill Instructions |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | **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. |
| 8 | |
| 9 | Use cases: |
| 10 | |
| 11 | - Morning briefing: what's blowing up in your niche right now? |
| 12 | - Competitor research: what's their content strategy and where are their gaps? |
| 13 | - Content calendar: find topics with social traction before they peak in SEO tools |
| 14 | - Market research: understand audience intent at the conversation level |
| 15 | |
| 16 | --- |
| 17 | |
| 18 | ## When to Use |
| 19 | |
| 20 | | Situation | What to do | |
| 21 | | ---------------------------------- | -------------------------------------------------- | |
| 22 | | "What should I write about today?" | Scout X + Reddit for trending topics in your niche | |
| 23 | | "What is my competitor doing?" | Discover + analyze competitor domains | |
| 24 | | "What content am I missing?" | Generate content gaps vs competitor URLs | |
| 25 | | "Morning briefing on AI trends" | Full workflow: X scout + Reddit scout + gaps | |
| 26 | | "Find competitors in [niche]" | Discover competitors by keywords | |
| 27 | |
| 28 | --- |
| 29 | |
| 30 | ## Setup |
| 31 | |
| 32 | ### 1. Register your agent |
| 33 | |
| 34 | ```http |
| 35 | POST https://www.citedy.com/api/agent/register |
| 36 | Content-Type: application/json |
| 37 | |
| 38 | { |
| 39 | "name": "My Trend Scout", |
| 40 | "blog_url": "https://yourblog.com" |
| 41 | } |
| 42 | ``` |
| 43 | |
| 44 | **Response:** |
| 45 | |
| 46 | ```json |
| 47 | { |
| 48 | "api_key": "citedy_agent_xxxxxxxxxxxx", |
| 49 | "tenant_id": "uuid", |
| 50 | "blog_handle": "yourblog", |
| 51 | "credits": 100 |
| 52 | } |
| 53 | ``` |
| 54 | |
| 55 | Store `api_key` as `CITEDY_API_KEY` in your environment. |
| 56 | |
| 57 | ### 2. Authenticate all requests |
| 58 | |
| 59 | All API calls require: |
| 60 | |
| 61 | ``` |
| 62 | Authorization: Bearer $CITEDY_API_KEY |
| 63 | ``` |
| 64 | |
| 65 | ### 3. Verify setup |
| 66 | |
| 67 | ```http |
| 68 | GET https://www.citedy.com/api/agent/health |
| 69 | Authorization: Bearer $CITEDY_API_KEY |
| 70 | ``` |
| 71 | |
| 72 | ```json |
| 73 | { "status": "ok", "version": "3.0.0" } |
| 74 | ``` |
| 75 | |
| 76 | --- |
| 77 | |
| 78 | ## Core Workflows |
| 79 | |
| 80 | ### Workflow 1 — Scout X/Twitter for trending topics |
| 81 | |
| 82 | **Step 1: Start the scout run** |
| 83 | |
| 84 | ```http |
| 85 | POST https://www.citedy.com/api/agent/scout/x |
| 86 | Authorization: Bearer $CITEDY_API_KEY |
| 87 | Content-Type: application/json |
| 88 | |
| 89 | { |
| 90 | "query": "AI content automation", |
| 91 | "mode": "fast", |
| 92 | "limit": 20 |
| 93 | } |
| 94 | ``` |
| 95 | |
| 96 | Response: |
| 97 | |
| 98 | ```json |
| 99 | { |
| 100 | "run_id": "x_run_abc123", |
| 101 | "status": "processing", |
| 102 | "estimated_seconds": 15 |
| 103 | } |
| 104 | ``` |
| 105 | |
| 106 | **Step 2: Poll for results** (poll every 5s until `status: "completed"`) |
| 107 | |
| 108 | ```http |
| 109 | GET https://www.citedy.com/api/agent/scout/x/x_run_abc123 |
| 110 | Authorization: Bearer $CITEDY_API_KEY |
| 111 | ``` |
| 112 | |
| 113 | ```json |
| 114 | { |
| 115 | "run_id": "x_run_abc123", |
| 116 | "status": "completed", |
| 117 | "results": [ |
| 118 | { |
| 119 | "topic": "GPT-5 rumored release date", |
| 120 | "engagement_score": 94, |
| 121 | "tweet_count": 1240, |
| 122 | "sentiment": "excited", |
| 123 | "top_posts": ["..."], |
| 124 | "content_angle": "Break down what GPT-5 means for content creators" |
| 125 | } |
| 126 | ], |
| 127 | "credits_used": 35 |
| 128 | } |
| 129 | ``` |
| 130 | |
| 131 | --- |
| 132 | |
| 133 | ### Workflow 2 — Scout Reddit for audience intent |
| 134 | |
| 135 | **Step 1: Start the scout run** |
| 136 | |
| 137 | ```http |
| 138 | POST https://www.citedy.com/api/agent/scout/reddit |
| 139 | Authorization: Bearer $CITEDY_API_KEY |
| 140 | Content-Type: application/json |
| 141 | |
| 142 | { |
| 143 | "query": "AI writing tools comparison", |
| 144 | "subreddits": ["SEO", "marketing", "artificial"], |
| 145 | "limit": 15 |
| 146 | } |
| 147 | ``` |
| 148 | |
| 149 | Response: |
| 150 | |
| 151 | ```json |
| 152 | { |
| 153 | "run_id": "reddit_run_xyz789", |
| 154 | "status": "processing", |
| 155 | "estimated_seconds": 12 |
| 156 | } |
| 157 | ``` |
| 158 | |
| 159 | **Step 2: Poll for results** |
| 160 | |
| 161 | ```http |
| 162 | GET https://www.citedy.com/api/agent/scout/reddit/reddit_run_xyz789 |
| 163 | Authorization: Bearer $CITEDY_API_KEY |
| 164 | ``` |
| 165 | |
| 166 | ```json |
| 167 | { |
| 168 | "run_id": "reddit_run_xyz789", |
| 169 | "status": "completed", |
| 170 | "results": [ |
| 171 | { |
| 172 | "topic": "People frustrated with Jasper pricing", |
| 173 | "subreddit": "r/SEO", |
| 174 | "upvotes": 847, |
| 175 | "comments": 134, |
| 176 | "pain_point": "Too expensive for small teams", |
| 177 | "content_angle": "Write a comparison targeting budget-conscious teams" |
| 178 | } |
| 179 | ], |
| 180 | "credits_used": 30 |
| 181 | } |
| 182 | ``` |
| 183 | |
| 184 | --- |
| 185 | |
| 186 | ### Workflow 3 — Find content ga |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
