Skill Reference

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
• Direct publish article content as-is to LinkedIn, Facebook, X, Reddit, Instagram (0 credits, no AI adaptation)
• 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)
• 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
• 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

​

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 (LinkedIn, X, Reddit, Instagram). Other platforms 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.2.0 https://www.citedy.com