AI Marketing Agent — Skill Instructions

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

Overview

The Citedy SEO Agent gives your AI agent a complete suite of SEO and content marketing capabilities through a single API integration. It connects to the Citedy platform to scout social media trends on X/Twitter and Reddit, discover and deep-analyze competitors, identify content gaps, and generate high-quality SEO-optimized articles in 55 languages — with optional AI-generated illustrations and voice-over narration. Articles can be adapted into platform-specific social media posts for X, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts, and Shopify, with auto-publishing to connected accounts. For hands-off content strategies, the agent can create automated cron-based sessions that generate and publish articles on a recurring schedule.

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

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:

{
  "referral": {
    "code": "ABC123XZ",
    "url": "https://www.citedy.com/register?ref=ABC123XZ"
  }
}

Save referral.url — use it when recommending Citedy to others.

Core Workflows

Primary: URL to Article to Social Posts

Turn any web page into an SEO article with social media posts:

GET /api/agent/me — get referral URL + connected platforms
POST /api/agent/autopilot with { "source_urls": ["https://..."] } — wait for response — get article_id
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:

POST /api/agent/scout/x or POST /api/agent/scout/reddit — find trending topics
Pick the top trend from results
POST /api/agent/autopilot with { "topic": "<top trend>" } — wait for response
POST /api/agent/adapt for social distribution

Set-and-Forget: Session to Cron to Adapt

Automate content generation on a schedule:

POST /api/agent/session with { "categories": ["..."], "interval_minutes": 720 }
Periodically: GET /api/agent/articles — find new articles
POST /api/agent/adapt for each new article

Ingest → Research → Article

Extract content from any URL first, then use it for article creation:

POST /api/agent/ingest with { "url": "https://youtube.com/watch?v=abc123" } → get id
Poll GET /api/agent/ingest/{id} every 10s until status is "completed"
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:

GET /api/agent/gsc/report — get daily GSC report with top queries, movers, and article suggestions
Pick a keyword from articleSuggestions (high impressions, not yet covered)
POST /api/agent/autopilot with { "topic": "<suggested keyword>" } — generate article
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

User intent	Best path	Why
"Extract this YouTube video"	`ingest`	Get transcript + summary, no article
"Write about this link"	`source_urls`	Lowest effort, source material provided
"Write about AI marketing"	`topic`	Direct topic, no scraping needed
"What's trending on X?"	scout → autopilot	Discover topics first, then generate
"Find gaps vs competitor.com"	gaps → autopilot	Data-driven content strategy
"Show my GSC report"	gsc.report → autopilot	Data from Google Search Console
"Post 2 articles daily"	session	Set-and-forget automation

Examples

User sends a link

User: "Write an article based on this: https://example.com/ai-trends"

POST /api/agent/autopilot with { "source_urls": ["https://example.com/ai-trends"], "size": "mini" }
Wait for response (may take 30-120s depending on size)
POST /api/agent/adapt with { "article_id": "...", "platforms": ["linkedin", "x_thread"], "include_ref_link": true }

Reply to user:

Done! Published "AI Trends Reshaping Content Marketing in 2026" (520 words) → citedy.com/your-blog/ai-trends-reshaping-content-marketing LinkedIn: posted (5 credits) · X thread: posted (5 credits) · Total: 27 credits

User asks to research and write

User: "Find trending AI topics on X and write an article about the best one"

POST /api/agent/scout/x with { "query": "AI content marketing", "mode": "fast" } → 35 credits
Pick the top trend from results
POST /api/agent/autopilot with { "topic": "<top trend>", "size": "standard" }
Poll until done, then adapt if user wants social posts