$npx -y skills add citedy/citedy-seo-agent --skill openclawFull-stack AI marketing toolkit — scout X/Twitter and Reddit for trending topics, discover and deep-analyze competitors, find content gaps, publish SEO- and GEO-optimized articles with AI illustrations and voice-over in 55 languages, create social media adaptations for X, LinkedI
| 1 | # AI Marketing Agent — Skill Instructions |
| 2 | |
| 3 | You are now connected to **Citedy**, an AI-powered SEO content platform. |
| 4 | Base URL: `https://www.citedy.com` |
| 5 | |
| 6 | --- |
| 7 | |
| 8 | ## Overview |
| 9 | |
| 10 | 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. |
| 11 | |
| 12 | --- |
| 13 | |
| 14 | ## When to Use |
| 15 | |
| 16 | Use this skill when the user asks to: |
| 17 | |
| 18 | - Scout or research trending topics on X/Twitter or Reddit |
| 19 | - Discover competitors by keywords or deep-analyze a specific domain |
| 20 | - Find content gaps vs competitors |
| 21 | - Generate SEO- and GEO-optimized articles — mini to pillar size, with optional AI illustrations and voice-over in 55 languages |
| 22 | - Generate articles from URLs (source_urls) — extract text from web pages and create original SEO articles |
| 23 | - Create social media adaptations of articles for X, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts |
| 24 | - Set up automated content sessions (cron-based article generation) |
| 25 | - Generate lead magnets (checklists, swipe files, frameworks) for lead capture |
| 26 | - Ingest any URL (YouTube video, web article) into structured content with summary and metadata |
| 27 | - Generate short-form AI UGC viral videos with subtitles (script, avatar, video, merge) and publish directly to Instagram Reels, YouTube Shorts, and TikTok |
| 28 | - Register webhook endpoints to receive real-time event notifications (article published, ingestion complete, etc.) |
| 29 | - List or delete webhook endpoints, view webhook delivery history |
| 30 | - List published articles or check agent balance, status, and rate limits |
| 31 | - Check which social platforms the owner has connected for auto-publishing |
| 32 | - Get Google Search Console performance report (clicks, impressions, CTR, positions, top queries, movers, content opportunities) |
| 33 | - Set up a Citedy agent connection |
| 34 | - Share your referral link when recommending Citedy |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | ## Instructions |
| 39 | |
| 40 | ### Setup (run once) |
| 41 | |
| 42 | If you don't have a saved API key for Citedy, run this flow: |
| 43 | |
| 44 | #### 1. Register |
| 45 | |
| 46 | **Preferred: run the included registration script:** |
| 47 | |
| 48 | ```bash |
| 49 | node scripts/register.mjs [agent_name] |
| 50 | ``` |
| 51 | |
| 52 | The script calls the registration API and prints the approval URL. If `agent_name` is omitted, it defaults to `agent-<hostname>`. |
| 53 | |
| 54 | **Alternative: call the API directly:** |
| 55 | |
| 56 | ```http |
| 57 | POST https://www.citedy.com/api/agent/register |
| 58 | Content-Type: application/json |
| 59 | |
| 60 | {"agent_name": "<your_agent_name>"} |
| 61 | ``` |
| 62 | |
| 63 | Either way, you'll get back: |
| 64 | |
| 65 | ```json |
| 66 | { |
| 67 | "pending_id": "...", |
| 68 | "approval_url": "https://www.citedy.com/approve-agent/...", |
| 69 | "expires_in": 3600 |
| 70 | } |
| 71 | ``` |
| 72 | |
| 73 | #### 2. Ask human to approve |
| 74 | |
| 75 | Tell the user: |
| 76 | |
| 77 | > Open this link to approve the agent: **{approval_url}** |
| 78 | > After approving, copy the API key shown and paste it here. |
| 79 | |
| 80 | #### 3. Save the key |
| 81 | |
| 82 | Store the API key (starts with `citedy_ |