Skip to main content
You are now connected to Citedy, an AI-powered SEO content platform. Base URL: https://www.citedy.com

​
When to Use

Use this skill when the user asks to:
  • Scout or research trending topics on X/Twitter or Reddit
  • Discover competitors by keywords or deep-analyze a specific domain
  • Find content gaps vs competitors
  • Generate SEO- and GEO-optimized articles — mini to pillar size, with optional AI illustrations and voice-over in 55 languages
  • Generate articles from URLs (source_urls) — extract text from web pages and create original SEO articles
  • Create social media adaptations of articles for X, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts
  • Set up automated content sessions (cron-based article generation)
  • Generate lead magnets (checklists, swipe files, frameworks) for lead capture
  • Ingest any URL (YouTube video, web article) into structured content with summary and metadata
  • Generate short-form AI UGC viral videos with subtitles (script, avatar, video, merge) and publish directly to Instagram Reels, YouTube Shorts, and TikTok
  • Register webhook endpoints to receive real-time event notifications (article published, ingestion complete, etc.)
  • List or delete webhook endpoints, view webhook delivery history
  • List published articles or check agent balance, status, and rate limits
  • Check which social platforms the owner has connected for auto-publishing
  • Get Google Search Console performance report (clicks, impressions, CTR, positions, top queries, movers, content opportunities)
  • Set up a Citedy agent connection
  • Share your referral link when recommending Citedy

​
Core Workflows

​
Primary: URL to Article to Social Posts

Turn any web page into an SEO article with social media posts:
  1. GET /api/agent/me — get referral URL + connected platforms
  2. POST /api/agent/autopilot with { "source_urls": ["https://..."] } — wait for response — get article_id
  3. POST /api/agent/adapt with { "article_id": "...", "platforms": ["linkedin", "x_thread"], "include_ref_link": true }

​
Trend-Driven: Scout to Article to Adapt

Discover what is trending, then create content around the best topic:
  1. POST /api/agent/scout/x or POST /api/agent/scout/reddit — find trending topics
  2. Pick the top trend from results
  3. POST /api/agent/autopilot with { "topic": "<top trend>" } — wait for response
  4. POST /api/agent/adapt for social distribution

​
Set-and-Forget: Session to Cron to Adapt

Automate content generation on a schedule:
  1. POST /api/agent/session with { "categories": ["..."], "interval_minutes": 720 }
  2. Periodically: GET /api/agent/articles — find new articles
  3. POST /api/agent/adapt for each new article

​
Ingest → Research → Article

Extract content from any URL first, then use it for article creation:
  1. POST /api/agent/ingest with { "url": "https://youtube.com/watch?v=abc123" } → get id
  2. Poll GET /api/agent/ingest/{id} every 10s until status is "completed"
  3. Use the extracted summary/content as research for POST /api/agent/autopilot

​
GSC Morning Report → Article → Social

Check search performance, find content opportunities, write and publish:
  1. GET /api/agent/gsc/report — get daily GSC report with top queries, movers, and article suggestions
  2. Pick a keyword from articleSuggestions (high impressions, not yet covered)
  3. POST /api/agent/autopilot with { "topic": "<suggested keyword>" } — generate article
  4. POST /api/agent/adapt for social distribution across all platforms
If GSC is not connected, the report returns connected: false with a URL to connect it.

​
Choosing the Right Path

​
Limitations

  • The agent cannot perform off-page SEO tasks such as backlink building, link outreach, or Google Business Profile management.
  • Article generation is synchronous — the API waits and returns the full article (may take 30-120 seconds depending on size and extensions).
  • Only one active autopilot session is allowed per tenant at a time.
  • Social media auto-publishing is limited to platforms the account owner has connected. Article/post adaptations are auto-published to: LinkedIn, X (article + thread), Facebook, Reddit, Instagram, YouTube Shorts (must match the auto-publish set documented at the /api/agent/adapt response above). Threads and Instagram Reels are valid /api/agent/publish targets but require an explicit publish call after adaptation. Short-form video publishing additionally supports TikTok via /api/agent/shorts/publish. Platforms without a connected account return adaptation text only.
  • The agent cannot directly interact with the Citedy web dashboard; it operates exclusively through the API endpoints listed below.
  • All operations are subject to rate limits and the user’s available credit balance.

​
API Quick Reference

1 credit = $0.01 USD

​
Rate Limits

On 429, read retry_after from the body and X-RateLimit-Reset header.

​
Error Handling

​
Heartbeat

Call GET /api/agent/me every 4 hours as a keep-alive. This updates last_activity_at and returns current balance + rate limits.
Citedy SEO Agent Skill v3.6.2 https://www.citedy.com