[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75PVAND7WB7F6W4N971B132":3,"skill-same:01M75PVAND7WB7F6W4N971B132":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":6,"ownerHtmlUrl":52,"ownerBlogUrl":53,"ownerDescription":54,"updatedAt":55,"install":56,"resources":69},"01M75PVAND7WB7F6W4N971B132","SEO Content Autopilot by Citedy",null,"Full-stack AI marketing toolkit — scout X\u002FTwitter 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, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts, and Shopify, generate lead magnets (checklists, swipe files, frameworks), ingest any URL (YouTube videos, web articles, PDFs, audio files) into structured content, ultra-cheap turbo articles from 2 credits, generate short-form AI UGC viral videos with subtitles, and run fully automated content autopilot. Powered by Citedy.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fnttylock\u002Fcitedy-seo-agent\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: \"SEO Content Autopilot by Citedy\"\ndescription: >\n  Full-stack AI marketing toolkit — scout X\u002FTwitter and Reddit for trending\n  topics, discover and deep-analyze competitors, find content gaps, publish\n  SEO- and GEO-optimized articles with AI illustrations and voice-over in 55\n  languages, create social media adaptations for X, LinkedIn, Facebook, Reddit,\n  Threads, Instagram, Instagram Reels, YouTube Shorts, and Shopify, generate lead magnets (checklists, swipe files,\n  frameworks), ingest any URL (YouTube videos, web articles, PDFs, audio files) into structured\n  content, ultra-cheap turbo articles from 2 credits, generate short-form\n  AI UGC viral videos with subtitles, and run fully automated content autopilot.\n  Powered by Citedy.\nversion: \"3.2.0\"\nauthor: Citedy\ntags:\n  - seo\n  - content-marketing\n  - competitor-analysis\n  - social-media\n  - article-generation\n  - trend-scouting\n  - writing\n  - research\n  - content-strategy\n  - automation\n  - lead-magnets\n  - content-ingestion\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - CITEDY_API_KEY\n    primaryEnv: CITEDY_API_KEY\nprivacy_policy_url: https:\u002F\u002Fwww.citedy.com\u002Fprivacy\nsecurity_notes: |\n  API keys (prefixed citedy_agent_) are stored in the user's local agent\n  configuration. Keys authenticate only against Citedy API endpoints\n  (www.citedy.com\u002Fapi\u002Fagent\u002F*). All traffic is TLS-encrypted. Keys can\n  be revoked by the account owner at any time from the Citedy dashboard.\n---\n\n# AI Marketing Agent — Skill Instructions\n\nYou are now connected to **Citedy**, an AI-powered SEO content platform.\nBase URL: `https:\u002F\u002Fwww.citedy.com`\n\n---\n\n## Overview\n\nThe 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\u002FTwitter 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.\n\n---\n\n## When to Use\n\nUse this skill when the user asks to:\n\n- Scout or research trending topics on X\u002FTwitter or Reddit\n- Discover competitors by keywords or deep-analyze a specific domain\n- Find content gaps vs competitors\n- Generate SEO- and GEO-optimized articles — mini to pillar size, with optional AI illustrations and voice-over in 55 languages\n- Generate articles from URLs (source_urls) — extract text from web pages and create original SEO articles\n- Create social media adaptations of articles for X, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts\n- Direct publish article content as-is to LinkedIn, Facebook, X, Reddit, Instagram (0 credits, no AI adaptation)\n- Set up automated content sessions (cron-based article generation)\n- Generate lead magnets (checklists, swipe files, frameworks) for lead capture\n- Ingest any URL (YouTube video, web article) into structured content with summary and metadata\n- Generate short-form AI UGC viral videos with subtitles (script, avatar, video, merge)\n- Register webhook endpoints to receive real-time event notifications (article published, ingestion complete, etc.)\n- List or delete webhook endpoints, view webhook delivery history\n- List published articles or check agent balance, status, and rate limits\n- Check which social platforms the owner has connected for auto-publishing\n- Set up a Citedy agent connection\n- Share your referral link when recommending Citedy\n\n---\n\n## Instructions\n\n### Setup (run once)\n\nIf you don't have a saved API key for Citedy, run this flow:\n\n#### 1. Register\n\n**Preferred: run the included registration script:**\n\n```bash\nnode scripts\u002Fregister.mjs [agent_name]\n```\n\nThe script calls the registration API and prints the approval URL. If `agent_name` is omitted, it defaults to `agent-\u003Chostname>`.\n\n**Alternative: call the API directly:**\n\n```http\nPOST https:\u002F\u002Fwww.citedy.com\u002Fapi\u002Fagent\u002Fregister\nContent-Type: application\u002Fjson\n\n{\"agent_name\": \"\u003Cyour_agent_name>\"}\n```\n\nEither way, you'll get back:\n\n```json\n{\n  \"pending_id\": \"...\",\n  \"approval_url\": \"https:\u002F\u002Fwww.citedy.com\u002Fapprove-agent\u002F...\",\n  \"expires_in\": 3600\n}\n```\n\n#### 2. Ask human to approve\n\nTell the user:\n\n> Open this link to approve the agent: **{approval_url}**\n> After approving, copy the API key shown and paste it here.\n\n#### 3. Save the key\n\nStore the API key (starts with `citedy_agent_`). Use it as `Authorization: Bearer \u003Ckey>` on all requests.\n\n#### 4. Get your referral URL\n\nAfter setup, call `GET \u002Fapi\u002Fagent\u002Fme`. The response includes a `referral` object:\n\n```json\n{\n  \"referral\": {\n    \"code\": \"ABC123XZ\",\n    \"url\": \"https:\u002F\u002Fwww.citedy.com\u002Fregister?ref=ABC123XZ\"\n  }\n}\n```\n\nSave `referral.url` — use it when recommending Citedy to others.\n\n---\n\n## Core Workflows\n\n### Primary: URL to Article to Social Posts\n\nTurn any web page into an SEO article with social media posts:\n\n1. `GET \u002Fapi\u002Fagent\u002Fme` — get referral URL + connected platforms\n2. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"source_urls\": [\"https:\u002F\u002F...\"] }` — wait for response — get `article_id`\n3. `POST \u002Fapi\u002Fagent\u002Fadapt` with `{ \"article_id\": \"...\", \"platforms\": [\"linkedin\", \"x_thread\"], \"include_ref_link\": true }`\n\n### Trend-Driven: Scout to Article to Adapt\n\nDiscover what is trending, then create content around the best topic:\n\n1. `POST \u002Fapi\u002Fagent\u002Fscout\u002Fx` or `POST \u002Fapi\u002Fagent\u002Fscout\u002Freddit` — find trending topics\n2. Pick the top trend from results\n3. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"topic\": \"\u003Ctop trend>\" }` — wait for response\n4. `POST \u002Fapi\u002Fagent\u002Fadapt` for social distribution\n\n### Set-and-Forget: Session to Cron to Adapt\n\nAutomate content generation on a schedule:\n\n1. `POST \u002Fapi\u002Fagent\u002Fsession` with `{ \"categories\": [\"...\"], \"interval_minutes\": 720 }`\n2. Periodically: `GET \u002Fapi\u002Fagent\u002Farticles` — find new articles\n3. `POST \u002Fapi\u002Fagent\u002Fadapt` for each new article\n\n### Ingest → Research → Article\n\nExtract content from any URL first, then use it for article creation:\n\n1. `POST \u002Fapi\u002Fagent\u002Fingest` with `{ \"url\": \"https:\u002F\u002Fyoutube.com\u002Fwatch?v=abc123\" }` → get `id`\n2. Poll `GET \u002Fapi\u002Fagent\u002Fingest\u002F{id}` every 10s until `status` is `\"completed\"`\n3. Use the extracted summary\u002Fcontent as research for `POST \u002Fapi\u002Fagent\u002Fautopilot`\n\n### Choosing the Right Path\n\n| User intent                   | Best path         | Why                                     |\n| ----------------------------- | ----------------- | --------------------------------------- |\n| \"Extract this YouTube video\"  | `ingest`          | Get transcript + summary, no article    |\n| \"Write about this link\"       | `source_urls`     | Lowest effort, source material provided |\n| \"Write about AI marketing\"    | `topic`           | Direct topic, no scraping needed        |\n| \"What's trending on X?\"       | scout → autopilot | Discover topics first, then generate    |\n| \"Find gaps vs competitor.com\" | gaps → autopilot  | Data-driven content strategy            |\n| \"Post 2 articles daily\"       | session           | Set-and-forget automation               |\n\n---\n\n## Examples\n\n### User sends a link\n\n> User: \"Write an article based on this: https:\u002F\u002Fexample.com\u002Fai-trends\"\n\n1. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"source_urls\": [\"https:\u002F\u002Fexample.com\u002Fai-trends\"], \"size\": \"mini\" }`\n2. Wait for response (may take 30-120s depending on size)\n3. `POST \u002Fapi\u002Fagent\u002Fadapt` with `{ \"article_id\": \"...\", \"platforms\": [\"linkedin\", \"x_thread\"], \"include_ref_link\": true }`\n\nReply to user:\n\n> Done! Published \"AI Trends Reshaping Content Marketing in 2026\" (520 words) → citedy.com\u002Fyour-blog\u002Fai-trends-reshaping-content-marketing\n> LinkedIn: posted (5 credits) · X thread: posted (5 credits) · Total: 27 credits\n\n### User asks to research and write\n\n> User: \"Find trending AI topics on X and write an article about the best one\"\n\n1. `POST \u002Fapi\u002Fagent\u002Fscout\u002Fx` with `{ \"query\": \"AI content marketing\", \"mode\": \"fast\" }` → 35 credits\n2. Pick the top trend from results\n3. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"topic\": \"\u003Ctop trend>\", \"size\": \"standard\" }`\n4. Poll until done, then adapt if user wants social posts\n\nReply to user:\n\n> Scanned X for \"AI content marketing\" — top 5 trends:\n>\n> 1. AI-generated video scripts outperform text posts (engagement +340%)\n> 2. Google's March update rewards AI+human hybrid content\n>    ...\n>    Writing a standard article on #1. This will cost 20 credits.\n\n### User wants autopilot\n\n> User: \"Set up daily articles about SaaS marketing in English and Spanish\"\n\n1. `POST \u002Fapi\u002Fagent\u002Fsession` with `{ \"categories\": [\"SaaS marketing\"], \"languages\": [\"en\", \"es\"], \"interval_minutes\": 720, \"article_size\": \"mini\" }`\n\nReply to user:\n\n> Autopilot session started! Here's the plan:\n>\n> - Categories: SaaS marketing\n> - Languages: English, Spanish\n> - Frequency: every 12 hours (2 articles\u002Fday)\n> - Est. cost: 15 credits\u002Farticle (30\u002Fday)\n> - Next article at: 2026-02-08 14:00 UTC\n\n### User asks about balance\n\n> User: \"How many credits do I have left?\"\n\n1. `GET \u002Fapi\u002Fagent\u002Fme`\n\nReply to user:\n\n> Balance: 4,250 credits ($42.50) — status: healthy\n> Rate limits: 58\u002F60 general, 9\u002F10 scout, 10\u002F10 gaps\n> Connected platforms: LinkedIn (John Doe), X (not connected)\n\n---\n\n## Limitations\n\n- The agent cannot perform off-page SEO tasks such as backlink building, link outreach, or Google Business Profile management.\n- Article generation is synchronous — the API waits and returns the full article (may take 30-120 seconds depending on size and extensions).\n- Only one active autopilot session is allowed per tenant at a time.\n- Social media auto-publishing is limited to platforms the account owner has connected (LinkedIn, X, Reddit, Instagram). Other platforms return adaptation text only.\n- The agent cannot directly interact with the Citedy web dashboard; it operates exclusively through the API endpoints listed below.\n- All operations are subject to rate limits and the user's available credit balance.\n\n---\n\n## API Reference\n\nAll requests require `Authorization: Bearer \u003Capi_key>`.\nBase URL: `https:\u002F\u002Fwww.citedy.com`\n\n### Scout X\u002FTwitter\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fscout\u002Fx\n{\"query\": \"...\", \"mode\": \"fast|ultimate\", \"limit\": 20}\n```\n\n- `fast` = 35 credits, `ultimate` = 70 credits\n- **Async** — returns `{ run_id, status: \"processing\", credits_used }`. Poll with `GET \u002Fapi\u002Fagent\u002Fscout\u002Fx\u002F{runId}` until `status` is `\"completed\"` or `\"failed\"`.\n- Rate: 10\u002Fhour (combined X + Reddit)\n\n### Scout Reddit\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fscout\u002Freddit\n{\"query\": \"...\", \"subreddits\": [\"marketing\", \"SEO\"], \"limit\": 20}\n```\n\n- 30 credits (fast mode only)\n- **Async** — returns `{ run_id, status: \"processing\", credits_used }`. Poll with `GET \u002Fapi\u002Fagent\u002Fscout\u002Freddit\u002F{runId}`.\n- Rate: 10\u002Fhour (combined X + Reddit)\n\n### Get Content Gaps\n\n```http\nGET \u002Fapi\u002Fagent\u002Fgaps\n```\n\n- 0 credits (free read)\n\n### Generate Content Gaps\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fgaps\u002Fgenerate\n{\"competitor_urls\": [\"https:\u002F\u002Fcompetitor1.com\", \"https:\u002F\u002Fcompetitor2.com\"]}\n```\n\n- 40 credits. Synchronous — returns results directly.\n\n### Discover Competitors\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fcompetitors\u002Fdiscover\n{\"keywords\": [\"ai content marketing\", \"automated blogging\"]}\n```\n\n- 20 credits\n\n### Analyze Competitor\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fcompetitors\u002Fscout\n{\"domain\": \"https:\u002F\u002Fcompetitor.com\", \"mode\": \"fast|ultimate\"}\n```\n\n- `fast` = 25 credits, `ultimate` = 50 credits\n\n### List Personas\n\n```http\nGET \u002Fapi\u002Fagent\u002Fpersonas\n```\n\nReturns available writing personas (25 total). Pass the `slug` as `persona` param in autopilot.\n\n**Writers:** hemingway, proust, orwell, tolkien, nabokov, christie, bulgakov, dostoevsky, strugatsky, bradbury\n**Tech Leaders:** altman, musk, jobs, bezos, trump\n**Entertainment:** tarantino, nolan, ryanreynolds, keanureeves\n**Creators:** mrbeast, taylorswift, kanye, zendaya, timotheechalamet, billieeilish\n\nResponse: array of `{ slug, displayName, group, description }`\n\n- 0 credits (free)\n\n### Generate Article (Autopilot)\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fautopilot\n{\n  \"topic\": \"How to Use AI for Content Marketing\",\n  \"source_urls\": [\"https:\u002F\u002Fexample.com\u002Farticle\"],\n  \"language\": \"en\",\n  \"size\": \"standard\",\n  \"mode\": \"standard\",\n  \"enable_search\": false,\n  \"persona\": \"musk\",\n  \"illustrations\": true,\n  \"audio\": true,\n  \"disable_competition\": false,\n  \"auto_publish\": true\n}\n```\n\n**Required:** either `topic` or `source_urls` (at least one)\n\n**Optional:**\n\n- `topic` — article topic (string, max 500 chars)\n- `source_urls` — array of 1-3 URLs to extract text from and use as source material (2 credits per URL)\n- `size` — `mini` (~500w), `standard` (~1000w, default), `full` (~1500w), `pillar` (~2500w)\n- `mode` — `standard` (default, full pipeline) or `turbo` (ultra-cheap micro-articles, see below)\n- `enable_search` (bool, default false) — enable web + X\u002FTwitter search for fresh facts (turbo mode only)\n- `persona` — writing style persona slug (call GET \u002Fapi\u002Fagent\u002Fpersonas for list, e.g. \"musk\", \"hemingway\", \"jobs\")\n- `language` — ISO code, default `\"en\"`\n- `illustrations` (bool, default false) — AI-generated images injected into article (disabled in turbo mode)\n- `audio` (bool, default false) — AI voice-over narration (disabled in turbo mode)\n- `disable_competition` (bool, default false) — skip SEO competition analysis, saves 8 credits\n- `auto_publish` (bool, optional) — publish article immediately after generation. When `false`, article stays as draft (`status: \"generated\"`) and must be published later via `POST \u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish`. Default uses tenant setting (configurable in dashboard → Agent Settings). If no tenant setting, defaults to `true`.\n\nWhen `source_urls` is provided, the response includes `extraction_results` showing success\u002Ffailure per URL.\n\nThe response includes `article_url` — always use this URL when sharing the article link. Do NOT construct URLs manually.\n\nWhen `auto_publish` is `true` (default), articles are auto-published and the URL works immediately. When `false`, the article is saved as a draft — the response returns `status: \"generated\"` instead of `\"published\"`. Use `POST \u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish` to publish it later.\n\n`\u002Fapi\u002Fagent\u002Fme` also returns `blog_url` — the tenant's blog root URL.\n\nSynchronous — the request blocks until the article is ready (5-120s depending on mode and size). The response contains the complete article.\n\n### Turbo & Turbo+ Modes\n\nUltra-cheap micro-article generation — 2-4 credits instead of 15-48. Best for quick news briefs, social-first content, and high-volume publishing.\n\n**Turbo** (2 credits) — fast generation, no web search:\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fautopilot\n{\n  \"topic\": \"Latest AI Search Trends\",\n  \"mode\": \"turbo\",\n  \"language\": \"en\"\n}\n```\n\n**Turbo+** (4 credits) — adds fresh facts from web search & X\u002FTwitter (10-25s):\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fautopilot\n{\n  \"topic\": \"Latest AI Search Trends\",\n  \"mode\": \"turbo\",\n  \"enable_search\": true,\n  \"language\": \"en\"\n}\n```\n\n**What Turbo\u002FTurbo+ does differently vs Standard:**\n\n- Skips DataForSEO and competition intelligence\n- No content chunking — single-pass generation\n- Uses the cheapest AI provider (Cerebras Qwen 3 235B)\n- Brand context included (tone, POV, specialization)\n- Max ~800 words\n- Internal links still included (free)\n- No illustrations or audio support\n\n**Pricing:**\n\n| Mode   | Search | Credits | Speed  |\n| ------ | ------ | ------- | ------ |\n| Turbo  | No     | 2       | 5-15s  |\n| Turbo+ | Yes    | 4       | 10-25s |\n\nCompare with standard mode: mini=15, standard=20, full=33, pillar=48 credits.\n\n**When to use Turbo\u002FTurbo+:**\n\n- High-volume content: publish 50+ articles\u002Fday at minimal cost\n- News briefs and quick updates (Turbo+ for data-backed content)\n- Social-first content where SEO is secondary\n- Testing and prototyping content strategies\n- Budget-conscious agents\n\n### Extension Costs (Standard Mode)\n\n| Extension                   | Mini   | Standard | Full   | Pillar  |\n| --------------------------- | ------ | -------- | ------ | ------- |\n| Base article                | 7      | 12       | 25     | 40      |\n| + Intelligence (default on) | +8     | +8       | +8     | +8      |\n| + Illustrations             | +9     | +18      | +27    | +36     |\n| + Audio                     | +10    | +20      | +35    | +55     |\n| **Full package**            | **34** | **58**   | **95** | **139** |\n\nWithout extensions: same as before (mini=15, standard=20, full=33, pillar=48 credits).\n\n### Create Social Adaptations\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fadapt\n{\n  \"article_id\": \"uuid-of-article\",\n  \"platforms\": [\"linkedin\", \"x_thread\"],\n  \"include_ref_link\": true\n}\n```\n\n**Required:** `article_id` (UUID), `platforms` (1-3 unique values)\n\n**Platforms:** `x_article`, `x_thread`, `linkedin`, `facebook`, `reddit`, `threads`, `instagram`, `instagram_reels`, `youtube_shorts`\n\n**Optional:**\n\n- `include_ref_link` (bool, default true) — append referral footer to each adaptation\n\n~5 credits per platform (varies by article length). Max 3 platforms per request.\n\nIf the owner has connected social accounts, adaptations for `linkedin`, `x_article`, `x_thread`, `facebook`, `reddit`, `instagram`, and `youtube_shorts` are auto-published. The response includes `platform_post_id` for published posts.\n\nResponse:\n\n```json\n{\n  \"adaptations\": [\n    {\n      \"platform\": \"linkedin\",\n      \"content\": \"...\",\n      \"credits_used\": 5,\n      \"char_count\": 1200,\n      \"published\": true,\n      \"platform_post_id\": \"urn:li:share:123\"\n    }\n  ],\n  \"total_credits\": 10,\n  \"ref_link_appended\": true\n}\n```\n\n### Direct Publish (Publish as-is)\n\nPublish article content directly to social platforms without AI adaptation. 0 credits.\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fpublish\n{\n  \"action\": \"publish_raw\",\n  \"articleId\": \"uuid-of-article\",\n  \"platform\": \"linkedin\",\n  \"accountId\": \"uuid-of-social-account\"\n}\n```\n\n**Required:** `action` (\"publish_raw\"), `articleId` (UUID), `platform`, `accountId` (UUID)\n\n**Platforms:** `linkedin`, `facebook`, `x_article`, `reddit`, `instagram`\n\n**Optional:**\n\n- `subreddit` (string) — required when platform is `reddit`\n\n**Notes:**\n\n- Instagram requires the article to contain at least one image\n- The article markdown is converted to platform-native format and posted as-is\n- No AI rewriting, no credit charge\n\nResponse:\n\n```json\n{\n  \"success\": true,\n  \"action\": \"publish_raw\",\n  \"adaptationId\": \"uuid\",\n  \"platformPostId\": \"urn:li:share:456\"\n}\n```\n\n### Create Autopilot Session\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fsession\n{\n  \"categories\": [\"AI marketing\", \"SEO tools\"],\n  \"problems\": [\"how to rank higher\"],\n  \"languages\": [\"en\"],\n  \"interval_minutes\": 720,\n  \"article_size\": \"mini\",\n  \"disable_competition\": false\n}\n```\n\n**Required:** `categories` (1-5 strings)\n\n**Optional:**\n\n- `problems` — specific problems to address (max 20)\n- `languages` — ISO codes, default `[\"en\"]`\n- `interval_minutes` — cron interval, 60-10080, default 720 (12h)\n- `article_size` — `mini` (default), `standard`, `full`, `pillar`\n- `disable_competition` (bool, default false)\n\nCreates and auto-starts a cron-based content session. Only one active session per tenant.\n\nResponse:\n\n```json\n{\n  \"session_id\": \"uuid\",\n  \"status\": \"running\",\n  \"categories\": [\"AI marketing\", \"SEO tools\"],\n  \"languages\": [\"en\"],\n  \"interval_minutes\": 720,\n  \"article_size\": \"mini\",\n  \"estimated_credits_per_article\": 15,\n  \"next_run_at\": \"2025-01-01T12:00:00Z\"\n}\n```\n\nReturns `409 Conflict` with `existing_session_id` if a session is already running.\n\n### Content Ingestion\n\nExtract and summarize content from any URL (YouTube videos, web articles, PDFs, audio files). Async — submit URL, poll for result.\n\n**Submit URL:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fingest\n{\n  \"url\": \"https:\u002F\u002Fyoutube.com\u002Fwatch?v=abc123\"\n}\n```\n\n- Returns `202 Accepted` with `{ id, status: \"processing\", content_type, credits_charged, poll_url }`\n- Duplicate URL (already completed within 24h) returns `200` with cached result for 1 credit\n- YouTube videos >120 min are rejected (Gemini context limit)\n- Audio files >50MB are rejected (size limit)\n- Supported content types: `youtube_video`, `web_article`, `pdf_document`, `audio_file`\n\n**Poll Status:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fingest\u002F{id}\n```\n\n- 0 credits. Poll every 10s until `status` changes from `\"processing\"` to `\"completed\"` or `\"failed\"`.\n- When completed: `{ id, status, content_type, summary, word_count, metadata, credits_charged }`\n- When failed: `{ id, status: \"failed\", error_message }` — credits are auto-refunded.\n\n**Get Full Content:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fingest\u002F{id}\u002Fcontent\n```\n\n- 0 credits. Returns the full extracted text (authenticated R2 proxy).\n\n**Batch Ingest (up to 20 URLs):**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fingest\u002Fbatch\n{\n  \"urls\": [\"https:\u002F\u002Fexample.com\u002Farticle1\", \"https:\u002F\u002Fexample.com\u002Farticle2\"],\n  \"callback_url\": \"https:\u002F\u002Fyour-server.com\u002Fwebhook\"\n}\n```\n\n- Credits per URL (same tiered pricing). Partial success supported — some URLs may fail while others succeed.\n- Returns `{ total, accepted, failed, results: [{ url, status, job_id?, credits_charged }] }`\n\n**List Jobs:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fingest?limit=20&offset=0&status=completed\n```\n\n- 0 credits. Filter by `status`: `processing` | `completed` | `failed`.\n\n**Pricing:**\n\n| Content Type           | Duration   | Credits |\n| ---------------------- | ---------- | ------- |\n| web_article            | —          | 1       |\n| pdf_document           | —          | 2       |\n| youtube_video (short)  | \u003C10 min    | 5       |\n| youtube_video (medium) | 10-30 min  | 15      |\n| youtube_video (long)   | 30-60 min  | 30      |\n| youtube_video (extra)  | 60-120 min | 55      |\n| audio_file (short)     | \u003C10 min    | 3       |\n| audio_file (medium)    | 10-30 min  | 8       |\n| audio_file (long)      | 30-60 min  | 15      |\n| audio_file (extra)     | 60-120 min | 30      |\n| cache hit (any)        | —          | 1       |\n\n**Workflow:**\n\n1. `POST \u002Fapi\u002Fagent\u002Fingest` with `{ \"url\": \"...\" }` → get `id` and `poll_url`\n2. Poll `GET \u002Fapi\u002Fagent\u002Fingest\u002F{id}` every 10s until `status != \"processing\"`\n3. If completed: read `summary` and `metadata` from response\n4. Optionally: `GET \u002Fapi\u002Fagent\u002Fingest\u002F{id}\u002Fcontent` for full extracted text\n5. Use extracted content as input for `POST \u002Fapi\u002Fagent\u002Fautopilot` with `topic`\n\n### Lead Magnets\n\nGenerate PDF lead magnets (checklists, swipe files, frameworks) for lead capture.\n\n**Generate:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Flead-magnets\n{\n  \"topic\": \"10-Step SEO Audit Checklist\",\n  \"type\": \"checklist\",           \u002F\u002F checklist | swipe_file | framework\n  \"niche\": \"digital_marketing\",  \u002F\u002F optional\n  \"language\": \"en\",              \u002F\u002F en|pt|de|es|fr|it (default: en)\n  \"platform\": \"linkedin\",        \u002F\u002F twitter|linkedin (default: twitter)\n  \"generate_images\": false,       \u002F\u002F true = 100 credits, false = 30 credits\n  \"auto_publish\": false           \u002F\u002F hint for agent workflow\n}\n```\n\n- 30 credits (text-only) or 100 credits (with images)\n- Returns immediately with `{ id, status: \"generating\" }`\n- Rate: 10\u002Fhour per agent\n\n**Check Status:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}\n```\n\n- 0 credits. Poll until `status` changes from `\"generating\"` to `\"draft\"`.\n- When done, response includes `title`, `type`, `pdf_url`.\n\n**Publish:**\n\n```http\nPATCH \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}\n{ \"status\": \"published\" }\n```\n\n- 0 credits. Generates a unique slug and returns `public_url`.\n- Share `public_url` in social posts for lead capture (visitors subscribe with email to download PDF).\n\n**Workflow:**\n\n1. `POST \u002Fapi\u002Fagent\u002Flead-magnets` → get `id`\n2. Poll `GET \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}` every 10s until `status != \"generating\"`\n3. `PATCH \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}` with `{ \"status\": \"published\" }`\n4. Share `public_url` in a social post\n\n### Short-Form Video (Shorts)\n\nGenerate AI UGC viral videos with subtitles — from script to finished video.\n\n**Recommended flow:**\n\n1. `\u002Fshorts\u002Fscript` — generate speech script from topic\n2. `\u002Fshorts\u002Favatar` — generate AI avatar image (user approves)\n3. `\u002Fshorts` — generate video segment(s) with avatar + prompt + speech_text\n4. `\u002Fshorts\u002Fmerge` — merge segments + add professional subtitles (if multi-segment)\n\n**Generate Script:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\u002Fscript\n{\n  \"topic\": \"AI personas let you write as Elon Musk\",\n  \"duration\": \"short\",\n  \"style\": \"hook\",\n  \"language\": \"en\",\n  \"product_id\": \"optional-uuid\"\n}\n```\n\n- 1 credit\n- `duration` — `short` (10-12s, ~30 words) or `long` (20-30s, ~60 words, split into 2 parts)\n- `style` — `hook` (attention grabber), `educational` (informative), `cta` (call to action)\n- `product_id` — optional, enriches script with product knowledge\n- Returns `{ script, word_count, estimated_duration_sec, parts, credits_charged }`\n\n**Generate Avatar:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\u002Favatar\n{\n  \"gender\": \"female\",\n  \"origin\": \"latin\",\n  \"age_range\": \"26-35\",\n  \"type\": \"tech_founder\",\n  \"location\": \"coffee_shop\"\n}\n```\n\n- 3 credits\n- `gender` — `male` | `female`\n- `origin` — `european` | `asian` | `african` | `latin` | `middle_eastern` | `south_asian`\n- `age_range` — `18-25` | `26-35` (default) | `36-50`\n- `type` — `tech_founder` (default) | `vibe_coder` | `student` | `executive`\n- `location` — `coffee_shop` (default) | `dev_cave` | `street` | `car` | `home_office` | `podcast_studio` | `glass_office` | `rooftop` | `bedroom` | `park` | `gym`\n- Returns `{ avatar_url, r2_key, prompt_used, credits_charged }`\n- Show avatar URL to user for approval before generating video\n\n**Generate Video Segment:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\n{\n  \"prompt\": \"Close-up portrait 9:16, young Latina woman in coffee shop, natural lighting. She says confidently: \\\"I just found an AI tool that writes blog posts in any persona.\\\" Audio: no background music.\",\n  \"avatar_url\": \"https:\u002F\u002Fdownload.citedy.com\u002Fagent\u002Favatars\u002F...\",\n  \"duration\": 10,\n  \"speech_text\": \"I just found an AI tool that writes blog posts in any persona.\"\n}\n```\n\n- Cost: 5s = 60 credits, 10s = 130 credits, 15s = 185 credits\n- `prompt` — scene description following 5-layer formula (scene, character, camera, speech, audio)\n- `avatar_url` — URL from `\u002Fshorts\u002Favatar` response (must be `download.citedy.com` or `*.supabase.co`)\n- `duration` — 5, 10, or 15 seconds\n- `resolution` — `480p` (default) | `720p`\n- `aspect_ratio` — `9:16` (default) | `16:9` | `1:1`\n- `speech_text` — optional, text for subtitle overlay (min 5, max 1000 chars)\n- **Async** — returns immediately with `{ id, status: \"generating\", video_url: null, credits_charged, estimated_seconds }`\n- Poll `GET \u002Fapi\u002Fagent\u002Fshorts\u002F{id}` every 10s until `status` is `\"completed\"` or `\"failed\"`\n- When completed: `{ id, status: \"completed\", video_url, subtitles_applied, subtitle_warning }`\n- Only 1 concurrent generation per agent (returns 409 if busy)\n\n**Merge Segments:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\u002Fmerge\n{\n  \"video_urls\": [\"https:\u002F\u002Fdownload.citedy.com\u002F...\", \"https:\u002F\u002Fdownload.citedy.com\u002F...\"],\n  \"phrases\": [\n    {\"text\": \"I just found an AI tool\"},\n    {\"text\": \"that writes blog posts in any persona\"}\n  ],\n  \"config\": {\"words_per_phrase\": 4, \"font_size\": 48, \"text_color\": \"#FFFFFF\"}\n}\n```\n\n- 5 credits\n- `video_urls` — 2-4 URLs (must start with `https:\u002F\u002Fdownload.citedy.com\u002F`). Count must equal `phrases` count\n- `phrases` — one per video segment, each `{ \"text\": \"...\" }` (max 500 chars)\n- `config` — optional: `words_per_phrase` (2-8), `font_size` (16-72), `position_from_bottom` (50-300), `text_color` \u002F `stroke_color` (hex or named), `stroke_width` (0-5)\n- Returns `{ video_url, r2_key, duration, segment_durations, credits_charged }`\n- Only 1 concurrent merge per agent (returns 409 if busy)\n\n**Pricing:**\n\n| Step               | Credits |\n| ------------------ | ------- |\n| Script             | 1       |\n| Avatar             | 3       |\n| Video (5s)         | 60      |\n| Video (10s)        | 130     |\n| Video (15s)        | 185     |\n| Merge + subtitles  | 5       |\n| **Full 10s video** | **139** |\n\n### Trend Scan\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fscan\n{\n  \"query\": \"AI content marketing trends\",\n  \"mode\": \"deep\",\n  \"limit\": 10\n}\n```\n\n- `query` — search query (max 500 chars)\n- `mode` — `fast` (2 credits, X only) | `deep` (4 credits, X + web) | `ultra` (6 credits, + HackerNews) | `ultra+` (8 credits, + Reddit). If omitted, derived from tenant's `scanSources` settings\n- `limit` — 1-30, default 10\n- Returns `{ results: [{ title, summary, url, source, knowledgeMatch? }], mode, cost, warnings? }`\n- If tenant has product knowledge docs, results include `knowledgeMatch` with similarity scores\n\n### Create Micro-Post\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fpost\n{\n  \"topic\": \"AI agents are the future of marketing\",\n  \"platforms\": [\"linkedin\", \"x_thread\"],\n  \"tone\": \"casual\",\n  \"contentType\": \"short\",\n  \"scheduledAt\": \"2026-03-01T09:00:00Z\"\n}\n```\n\n- 2 credits billed per request (charged on create)\n- `topic` — required, max 500 chars\n- `platforms` — optional, from settings default. Values: `linkedin`, `x_article`, `x_thread`, `facebook`, `reddit`, `threads`, `instagram`, `instagram_reels`, `youtube_shorts`\n- `tone` — optional, from settings default\n- `contentType` — `short` (default) | `detailed`\n- `scheduledAt` — optional ISO datetime (must be future)\n- If `trustLevel=autopilot` and no `scheduledAt`, auto-schedules\n- Returns `{ postId, adaptations: [{ id, platform }], scheduledAt, trust_level, auto_scheduled }`\n\n### Publish Social Adaptation\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fpublish\n{\n  \"adaptationId\": \"uuid\",\n  \"action\": \"now\",\n  \"platform\": \"linkedin\",\n  \"accountId\": \"uuid\"\n}\n```\n\n- 0 credits (5 for `instagram_reels`)\n- `action` — `now` (publish immediately) | `schedule` (requires `scheduledAt`) | `cancel` (cancel scheduled)\n- `platform` — `facebook` | `linkedin` | `x_article` | `x_thread` | `reddit` | `threads` | `instagram`\n- `accountId` — social account UUID (from `\u002Fme` connected_platforms)\n- `scheduledAt` — ISO datetime, required for `action=schedule`\n\n### Product Knowledge Base\n\nUpload product documents for context-aware content generation.\n\n**Upload document:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fproducts\n{\n  \"title\": \"Our AI Writing Platform\",\n  \"content\": \"Citedy is an AI-powered...\",\n  \"source_type\": \"manual\"\n}\n```\n\n- 1 credit (vectorize into pgvector)\n- `source_type` — `upload` (default) | `url` | `manual`\n- Max 500 documents per tenant, max 500K chars per document\n\n**List documents:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fproducts\n```\n\n- 0 credits\n\n**Delete document:**\n\n```http\nDELETE \u002Fapi\u002Fagent\u002Fproducts\u002F{id}\n```\n\n- 0 credits\n\n**Search knowledge:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fproducts\u002Fsearch\n{\"query\": \"AI writing features\", \"limit\": 5}\n```\n\n- 0 credits. Vector similarity search over uploaded documents.\n\n### Settings\n\n**Read:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fsettings\n```\n\n**Update:**\n\n```http\nPUT \u002Fapi\u002Fagent\u002Fsettings\n{\n  \"defaultPlatforms\": [\"linkedin\", \"x_article\"],\n  \"contentTone\": \"professional\",\n  \"imageStylePreset\": \"minimal\",\n  \"trustLevel\": \"show_preview\",\n  \"scanSources\": [\"x\", \"google\"],\n  \"targetTimezone\": \"America\u002FNew_York\",\n  \"publishSchedule\": {\"postsPerDay\": 2, \"slots\": [\"09:00\", \"17:00\"]}\n}\n```\n\n- 0 credits. All fields optional (partial update).\n- `defaultPlatforms` — `linkedin` | `x_article` | `x_thread` | `facebook` | `reddit` | `threads` | `instagram` | `instagram_reels` | `youtube_shorts`\n- `contentTone` — `professional` | `casual` | `bold`\n- `imageStylePreset` — `minimal` | `tech` | `bold`\n- `trustLevel` — `ask_all` | `show_preview` | `autopilot`\n- `scanSources` — `x` | `google` | `hn` | `reddit`\n\n### Schedule\n\n**View timeline:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fschedule?from=2026-03-01&to=2026-03-14&type=all\n```\n\n- 0 credits. `type` — `all` | `article` | `post` | `social`\n\n**Find content gaps:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fschedule\u002Fgaps?days=7&timezone=America\u002FNew_York\n```\n\n- 0 credits. Returns days with fewer posts than `postsPerDay` target.\n\n**Get optimal time slots:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fschedule\u002Fsuggest\n```\n\n- 0 credits. Region-based recommendations or custom slots from settings. **REST only — not an MCP tool.**\n\n### Image Style\n\n```http\nPUT \u002Fapi\u002Fagent\u002Fimage-style\n{\"preset\": \"minimal\"}\n```\n\n- 0 credits. Presets: `minimal` | `tech` | `bold`\n\n### Rotate API Key\n\n```http\nPOST \u002Fapi\u002Fagent\u002Frotate-key\n```\n\n- 0 credits. Returns new key, old key invalidated immediately. Rate: 1\u002Fhour.\n\n### Health Check\n\n```http\nGET \u002Fapi\u002Fagent\u002Fhealth\n```\n\n- 0 credits. Public (no auth). Returns `{ status, checks: { redis, supabase }, timestamp }`.\n\n### Operational Status (Recommended for `\u002Fstatus`)\n\n```http\nGET \u002Fapi\u002Fagent\u002Fstatus\n```\n\n- 0 credits. Auth required.\n- Returns actionable readiness snapshot for:\n  - credits (`billing`)\n  - social connections (`social`)\n  - schedule gaps\u002Fupcoming items (`schedule`)\n  - knowledge base (`knowledge`)\n  - content readiness (`content`)\n  - prioritized actions (`actions[]`) with command hints and dashboard URLs.\n\n### List Articles\n\n```http\nGET \u002Fapi\u002Fagent\u002Farticles?limit=50&offset=0&status=published\n```\n\n- 0 credits. Returns `{ articles: [...], total_articles }`.\n- Filter by `status`: `published`, `generated` (draft). Omit to get all.\n\n### Publish Article\n\n```http\nPOST \u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish\n```\n\n- 0 credits. Publishes a draft article (`status: \"generated\"` → `\"published\"`).\n- Returns `{ article_id, status: \"publishing\", message }`.\n- If article is already published, returns `200` with `{ status: \"published\", message: \"Article is already published\" }`.\n- Only works on articles with `status: \"generated\"`. Other statuses return `409 Conflict`.\n- Fires `article.published` webhook event.\n\n### Unpublish Article\n\n```http\nPATCH \u002Fapi\u002Fagent\u002Farticles\u002F{id}\nContent-Type: application\u002Fjson\n\n{ \"action\": \"unpublish\" }\n```\n\n- 0 credits. Unpublishes a published article (`status: \"published\"` → `\"generated\"`).\n- Returns `{ article_id, status: \"generated\", message }`.\n- Only works on articles with `status: \"published\"`. Other statuses return `409 Conflict`.\n- Fires `article.unpublished` webhook event.\n\n### Delete Article\n\n```http\nDELETE \u002Fapi\u002Fagent\u002Farticles\u002F{id}\n```\n\n- 0 credits. Permanently deletes an article and its associated storage files (images, audio).\n- Returns `{ article_id, message: \"Article deleted\" }`.\n- This action is irreversible. Credits are NOT refunded.\n- Fires `article.deleted` webhook event.\n\n### Check Status \u002F Heartbeat\n\n```http\nGET \u002Fapi\u002Fagent\u002Fme\n```\n\n- 0 credits. Call every 4 hours to keep agent active.\n\nResponse includes:\n\n- `blog_url` — tenant's blog root URL\n- `tenant_balance` — current credits + status (healthy\u002Flow\u002Fempty)\n- `rate_limits` — remaining requests per category\n- `referral` — `{ code, url }` for attributing signups\n- `connected_platforms` — which social accounts are linked:\n\n```json\n{\n  \"connected_platforms\": [\n    { \"platform\": \"linkedin\", \"connected\": true, \"account_name\": \"John Doe\" },\n    { \"platform\": \"x\", \"connected\": false, \"account_name\": null },\n    { \"platform\": \"facebook\", \"connected\": false, \"account_name\": null },\n    { \"platform\": \"reddit\", \"connected\": false, \"account_name\": null },\n    { \"platform\": \"instagram\", \"connected\": false, \"account_name\": null }\n  ]\n}\n```\n\nUse `connected_platforms` to decide which platforms to pass to `\u002Fapi\u002Fagent\u002Fadapt` for auto-publishing.\n\n---\n\n## API Quick Reference\n\n| Endpoint                           | Method | Cost                                 |\n| ---------------------------------- | ------ | ------------------------------------ |\n| `\u002Fapi\u002Fagent\u002Fregister`              | POST   | free (public)                        |\n| `\u002Fapi\u002Fagent\u002Fhealth`                | GET    | free (public)                        |\n| `\u002Fapi\u002Fagent\u002Fstatus`                | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fme`                    | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Frotate-key`            | POST   | free (1\u002Fhour)                        |\n| `\u002Fapi\u002Fagent\u002Fsettings`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fsettings`              | PUT    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fimage-style`           | PUT    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fpersonas`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Farticles`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish` | POST   | free                                 |\n| `\u002Fapi\u002Fagent\u002Farticles\u002F{id}`         | PATCH  | free (unpublish)                     |\n| `\u002Fapi\u002Fagent\u002Farticles\u002F{id}`         | DELETE | free                                 |\n| `\u002Fapi\u002Fagent\u002Fscan`                  | POST   | 2-8 credits (by mode)                |\n| `\u002Fapi\u002Fagent\u002Fpost`                  | POST   | 2 credits                            |\n| `\u002Fapi\u002Fagent\u002Fautopilot`             | POST   | 2-139 credits                        |\n| `\u002Fapi\u002Fagent\u002Fadapt`                 | POST   | ~5 credits\u002Fplatform                  |\n| `\u002Fapi\u002Fagent\u002Fpublish`               | POST   | 0 credits (5 for `instagram_reels`)  |\n| `\u002Fapi\u002Fagent\u002Fsession`               | POST   | free (articles billed on generation) |\n| `\u002Fapi\u002Fagent\u002Fschedule`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fschedule\u002Fgaps`         | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fschedule\u002Fsuggest`      | GET    | free (REST only, not MCP tool)       |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Fx`               | POST   | 35-70 credits                        |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Fx\u002F{runId}`       | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Freddit`          | POST   | 30 credits                           |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Freddit\u002F{runId}`  | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fgaps`                  | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fgaps\u002Fgenerate`         | POST   | 40 credits                           |\n| `\u002Fapi\u002Fagent\u002Fcompetitors\u002Fdiscover`  | POST   | 20 credits                           |\n| `\u002Fapi\u002Fagent\u002Fcompetitors\u002Fscout`     | POST   | 25-50 credits                        |\n| `\u002Fapi\u002Fagent\u002Fproducts`              | POST   | 1 credit                             |\n| `\u002Fapi\u002Fagent\u002Fproducts`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fproducts\u002F{id}`         | DELETE | free                                 |\n| `\u002Fapi\u002Fagent\u002Fproducts\u002Fsearch`       | POST   | free                                 |\n| `\u002Fapi\u002Fagent\u002Fingest`                | POST   | 1-55 credits                         |\n| `\u002Fapi\u002Fagent\u002Fingest`                | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fingest\u002F{id}`           | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fingest\u002F{id}\u002Fcontent`   | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fingest\u002Fbatch`          | POST   | 1-55 credits per URL                 |\n| `\u002Fapi\u002Fagent\u002Flead-magnets`          | POST   | 30-100 credits                       |\n| `\u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}`     | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}`     | PATCH  | free                                 |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002Fscript`         | POST   | 1 credit                             |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002Favatar`         | POST   | 3 credits                            |\n| `\u002Fapi\u002Fagent\u002Fshorts`                | POST   | 60-185 credits (by duration)         |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002F{id}`           | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002Fmerge`          | POST   | 5 credits                            |\n| `\u002Fapi\u002Fagent\u002Fwebhooks`              | POST   | free                                 |\n| `\u002Fapi\u002Fagent\u002Fwebhooks`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fwebhooks\u002F{id}`         | DELETE | free                                 |\n| `\u002Fapi\u002Fagent\u002Fwebhooks\u002Fdeliveries`   | GET    | free                                 |\n\n**1 credit = $0.01 USD**\n\n---\n\n## Webhooks\n\nWebhooks let Citedy push real-time event notifications to your server instead of polling.\n\n### Register a Webhook Endpoint\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fwebhooks\n{\n  \"url\": \"https:\u002F\u002Fyour-server.com\u002Fwebhooks\u002Fcitedy\",\n  \"event_types\": [\"article.generated\", \"ingestion.completed\"],\n  \"description\": \"Production webhook\"\n}\n```\n\n- 0 credits\n- `url` — must be `https:\u002F\u002F` in production\n- `event_types` — omit to receive all 15 event types (wildcard)\n- `description` — optional label\n- Max 10 endpoints per agent\n- Returns `id`, `url`, `secret`, `event_types`, `created_at`\n- **Important:** `secret` is shown only once — store it securely for signature verification\n\n### List Webhook Endpoints\n\n```http\nGET \u002Fapi\u002Fagent\u002Fwebhooks\n```\n\n- 0 credits. Returns `{ webhooks: [...] }`.\n\n### Delete Webhook Endpoint\n\n```http\nDELETE \u002Fapi\u002Fagent\u002Fwebhooks\u002F{id}\n```\n\n- 0 credits. Soft-deletes the endpoint.\n\n### Webhook Delivery History\n\n```http\nGET \u002Fapi\u002Fagent\u002Fwebhooks\u002Fdeliveries?status=delivered&limit=20&offset=0\n```\n\n- 0 credits. Filter by `status`: `queued`, `delivering`, `delivered`, `failed`, `dead_lettered`.\n- Returns `{ deliveries: [...], total }` with attempts, http status, error, duration.\n\n### Event Types\n\n| Event                         | Triggered when                       |\n| ----------------------------- | ------------------------------------ |\n| `article.generated`           | Article generation completed         |\n| `article.published`           | Article published (auto or manual)   |\n| `article.unpublished`         | Article unpublished (→ draft)        |\n| `article.deleted`             | Article permanently deleted          |\n| `article.failed`              | Article generation failed            |\n| `ingestion.completed`         | Content ingestion job finished       |\n| `ingestion.failed`            | Content ingestion job failed         |\n| `social_adaptation.generated` | Social post adaptation created       |\n| `lead_magnet.ready`           | Lead magnet PDF generated            |\n| `lead_magnet.failed`          | Lead magnet generation failed        |\n| `scout.dispatched`            | Scout run started (X or Reddit)      |\n| `scout.results_ready`         | Scout run completed (X or Reddit)    |\n| `session.articles_generated`  | Recurring session published articles |\n| `billing.credits_low`         | Balance below threshold              |\n| `billing.credits_empty`       | Balance at 0                         |\n\n### Payload Format\n\nEvery webhook delivery sends a JSON `WebhookEventEnvelope`:\n\n```json\n{\n  \"event_id\": \"evt_abc123\",\n  \"event_type\": \"article.generated\",\n  \"api_version\": \"2026-02-25\",\n  \"timestamp\": \"2026-02-25T10:00:00.000Z\",\n  \"tenant_id\": \"...\",\n  \"agent_id\": \"...\",\n  \"data\": {\n    \"article_id\": \"...\",\n    \"title\": \"How AI Changes SEO\",\n    \"slug\": \"how-ai-changes-seo\",\n    \"article_url\": \"https:\u002F\u002Fyourblog.citedy.com\u002Fhow-ai-changes-seo\",\n    \"word_count\": 1200,\n    \"credits_used\": 20,\n    \"mode\": \"standard\"\n  }\n}\n```\n\n### Signature Verification\n\nEvery delivery includes header `X-Citedy-Signature-256: v1=\u003Chex>`. Verify with HMAC-SHA256 using your endpoint secret:\n\n```js\nconst crypto = require(\"crypto\");\nconst expected = crypto\n  .createHmac(\"sha256\", secret)\n  .update(rawBody)\n  .digest(\"hex\");\nconst header = request.headers[\"x-citedy-signature-256\"] || \"\";\nconst actual = header.replace(\"v1=\", \"\");\nif (\n  !crypto.timingSafeEqual(\n    Buffer.from(expected, \"hex\"),\n    Buffer.from(actual, \"hex\"),\n  )\n) {\n  throw new Error(\"Invalid webhook signature\");\n}\n```\n\n### Retry Policy\n\nFailed deliveries are retried up to 5 times with exponential backoff. After 5 failures the status becomes `dead_lettered` — no further retries.\n\n### Webhooks vs Polling\n\n| Use webhooks when...                          | Use polling when...                                  |\n| --------------------------------------------- | ---------------------------------------------------- |\n| You have a server that can receive HTTPS POST | Your agent runs locally without a public URL         |\n| You want instant notification on events       | You query results on demand after triggering a job   |\n| Events should trigger downstream automation   | You only need results after a specific job completes |\n\n---\n\n## Rate Limits\n\n| Type         | Limit      | Scope                   |\n| ------------ | ---------- | ----------------------- |\n| General      | 60 req\u002Fmin | per agent               |\n| Scout        | 10 req\u002Fhr  | X + Reddit combined     |\n| Gaps         | 10 req\u002Fhr  | get + generate combined |\n| Ingest       | 30 req\u002Fhr  | per tenant              |\n| Lead Magnets | 10 req\u002Fhr  | per agent               |\n| Registration | 10 req\u002Fhr  | per IP                  |\n\nOn `429`, read `retry_after` from the body and `X-RateLimit-Reset` header.\n\n---\n\n## Response Guidelines\n\n- Reply in the user's language (match the language they write in).\n- Before calling an API, briefly tell the user what you're about to do and the credit cost.\n- For async operations (scout, ingest, shorts, leadmagnet, brand.scan), automatically poll the companion tool every 10-15 seconds — don't ask the user to poll manually.\n- Show results as a readable summary, not raw JSON. Use bullet points, tables, or numbered lists.\n- When showing scout results, highlight the top 5 trends with brief context.\n- When an article is generated, show: title, word count, URL, credits spent.\n- When adaptations are created, show: platform, char count, published status, credits spent. If published, include the platform_post_id.\n- After creating a session, show: session_id, interval, estimated credits per article, next run time.\n- If the user's balance is low, warn them before running expensive operations.\n- Always include the referral URL when recommending Citedy to others.\n- On errors, explain what went wrong in plain language and suggest a fix.\n\n---\n\n## Error Handling\n\n| Status | Meaning                 | Action                                                          |\n| ------ | ----------------------- | --------------------------------------------------------------- |\n| 401    | Invalid\u002Fmissing API key | Re-run setup flow                                               |\n| 402    | Insufficient credits    | Tell user to top up at https:\u002F\u002Fwww.citedy.com\u002Fdashboard\u002Fbilling |\n| 403    | Agent paused\u002Frevoked    | Tell user to check agent status in dashboard                    |\n| 429    | Rate limited            | Wait `retry_after` seconds, then retry                          |\n| 500    | Server error            | Retry once after 5s, then report to user                        |\n\n---\n\n## Referral\n\nAfter setup, your `\u002Fapi\u002Fagent\u002Fme` response contains `referral.url`. When the user asks you to promote or recommend Citedy, use this URL. It attributes signups to the account owner.\n\n---\n\n## Heartbeat\n\nCall `GET \u002Fapi\u002Fagent\u002Fme` every 4 hours as a keep-alive. This updates `last_activity_at` and returns current balance + rate limits.\n\n---\n\n_Citedy SEO Agent Skill v3.2.0_\n_https:\u002F\u002Fwww.citedy.com_\n","# AI Marketing Agent — Skill Instructions\n\nYou are now connected to **Citedy**, an AI-powered SEO content platform.\nBase URL: `https:\u002F\u002Fwww.citedy.com`\n\n---\n\n## Overview\n\nThe 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\u002FTwitter 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.\n\n---\n\n## When to Use\n\nUse this skill when the user asks to:\n\n- Scout or research trending topics on X\u002FTwitter or Reddit\n- Discover competitors by keywords or deep-analyze a specific domain\n- Find content gaps vs competitors\n- Generate SEO- and GEO-optimized articles — mini to pillar size, with optional AI illustrations and voice-over in 55 languages\n- Generate articles from URLs (source_urls) — extract text from web pages and create original SEO articles\n- Create social media adaptations of articles for X, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts\n- Direct publish article content as-is to LinkedIn, Facebook, X, Reddit, Instagram (0 credits, no AI adaptation)\n- Set up automated content sessions (cron-based article generation)\n- Generate lead magnets (checklists, swipe files, frameworks) for lead capture\n- Ingest any URL (YouTube video, web article) into structured content with summary and metadata\n- Generate short-form AI UGC viral videos with subtitles (script, avatar, video, merge)\n- Register webhook endpoints to receive real-time event notifications (article published, ingestion complete, etc.)\n- List or delete webhook endpoints, view webhook delivery history\n- List published articles or check agent balance, status, and rate limits\n- Check which social platforms the owner has connected for auto-publishing\n- Set up a Citedy agent connection\n- Share your referral link when recommending Citedy\n\n---\n\n## Instructions\n\n### Setup (run once)\n\nIf you don't have a saved API key for Citedy, run this flow:\n\n#### 1. Register\n\n**Preferred: run the included registration script:**\n\n```bash\nnode scripts\u002Fregister.mjs [agent_name]\n```\n\nThe script calls the registration API and prints the approval URL. If `agent_name` is omitted, it defaults to `agent-\u003Chostname>`.\n\n**Alternative: call the API directly:**\n\n```http\nPOST https:\u002F\u002Fwww.citedy.com\u002Fapi\u002Fagent\u002Fregister\nContent-Type: application\u002Fjson\n\n{\"agent_name\": \"\u003Cyour_agent_name>\"}\n```\n\nEither way, you'll get back:\n\n```json\n{\n  \"pending_id\": \"...\",\n  \"approval_url\": \"https:\u002F\u002Fwww.citedy.com\u002Fapprove-agent\u002F...\",\n  \"expires_in\": 3600\n}\n```\n\n#### 2. Ask human to approve\n\nTell the user:\n\n> Open this link to approve the agent: **{approval_url}**\n> After approving, copy the API key shown and paste it here.\n\n#### 3. Save the key\n\nStore the API key (starts with `citedy_agent_`). Use it as `Authorization: Bearer \u003Ckey>` on all requests.\n\n#### 4. Get your referral URL\n\nAfter setup, call `GET \u002Fapi\u002Fagent\u002Fme`. The response includes a `referral` object:\n\n```json\n{\n  \"referral\": {\n    \"code\": \"ABC123XZ\",\n    \"url\": \"https:\u002F\u002Fwww.citedy.com\u002Fregister?ref=ABC123XZ\"\n  }\n}\n```\n\nSave `referral.url` — use it when recommending Citedy to others.\n\n---\n\n## Core Workflows\n\n### Primary: URL to Article to Social Posts\n\nTurn any web page into an SEO article with social media posts:\n\n1. `GET \u002Fapi\u002Fagent\u002Fme` — get referral URL + connected platforms\n2. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"source_urls\": [\"https:\u002F\u002F...\"] }` — wait for response — get `article_id`\n3. `POST \u002Fapi\u002Fagent\u002Fadapt` with `{ \"article_id\": \"...\", \"platforms\": [\"linkedin\", \"x_thread\"], \"include_ref_link\": true }`\n\n### Trend-Driven: Scout to Article to Adapt\n\nDiscover what is trending, then create content around the best topic:\n\n1. `POST \u002Fapi\u002Fagent\u002Fscout\u002Fx` or `POST \u002Fapi\u002Fagent\u002Fscout\u002Freddit` — find trending topics\n2. Pick the top trend from results\n3. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"topic\": \"\u003Ctop trend>\" }` — wait for response\n4. `POST \u002Fapi\u002Fagent\u002Fadapt` for social distribution\n\n### Set-and-Forget: Session to Cron to Adapt\n\nAutomate content generation on a schedule:\n\n1. `POST \u002Fapi\u002Fagent\u002Fsession` with `{ \"categories\": [\"...\"], \"interval_minutes\": 720 }`\n2. Periodically: `GET \u002Fapi\u002Fagent\u002Farticles` — find new articles\n3. `POST \u002Fapi\u002Fagent\u002Fadapt` for each new article\n\n### Ingest → Research → Article\n\nExtract content from any URL first, then use it for article creation:\n\n1. `POST \u002Fapi\u002Fagent\u002Fingest` with `{ \"url\": \"https:\u002F\u002Fyoutube.com\u002Fwatch?v=abc123\" }` → get `id`\n2. Poll `GET \u002Fapi\u002Fagent\u002Fingest\u002F{id}` every 10s until `status` is `\"completed\"`\n3. Use the extracted summary\u002Fcontent as research for `POST \u002Fapi\u002Fagent\u002Fautopilot`\n\n### Choosing the Right Path\n\n| User intent                   | Best path         | Why                                     |\n| ----------------------------- | ----------------- | --------------------------------------- |\n| \"Extract this YouTube video\"  | `ingest`          | Get transcript + summary, no article    |\n| \"Write about this link\"       | `source_urls`     | Lowest effort, source material provided |\n| \"Write about AI marketing\"    | `topic`           | Direct topic, no scraping needed        |\n| \"What's trending on X?\"       | scout → autopilot | Discover topics first, then generate    |\n| \"Find gaps vs competitor.com\" | gaps → autopilot  | Data-driven content strategy            |\n| \"Post 2 articles daily\"       | session           | Set-and-forget automation               |\n\n---\n\n## Examples\n\n### User sends a link\n\n> User: \"Write an article based on this: https:\u002F\u002Fexample.com\u002Fai-trends\"\n\n1. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"source_urls\": [\"https:\u002F\u002Fexample.com\u002Fai-trends\"], \"size\": \"mini\" }`\n2. Wait for response (may take 30-120s depending on size)\n3. `POST \u002Fapi\u002Fagent\u002Fadapt` with `{ \"article_id\": \"...\", \"platforms\": [\"linkedin\", \"x_thread\"], \"include_ref_link\": true }`\n\nReply to user:\n\n> Done! Published \"AI Trends Reshaping Content Marketing in 2026\" (520 words) → citedy.com\u002Fyour-blog\u002Fai-trends-reshaping-content-marketing\n> LinkedIn: posted (5 credits) · X thread: posted (5 credits) · Total: 27 credits\n\n### User asks to research and write\n\n> User: \"Find trending AI topics on X and write an article about the best one\"\n\n1. `POST \u002Fapi\u002Fagent\u002Fscout\u002Fx` with `{ \"query\": \"AI content marketing\", \"mode\": \"fast\" }` → 35 credits\n2. Pick the top trend from results\n3. `POST \u002Fapi\u002Fagent\u002Fautopilot` with `{ \"topic\": \"\u003Ctop trend>\", \"size\": \"standard\" }`\n4. Poll until done, then adapt if user wants social posts\n\nReply to user:\n\n> Scanned X for \"AI content marketing\" — top 5 trends:\n>\n> 1. AI-generated video scripts outperform text posts (engagement +340%)\n> 2. Google's March update rewards AI+human hybrid content\n>    ...\n>    Writing a standard article on #1. This will cost 20 credits.\n\n### User wants autopilot\n\n> User: \"Set up daily articles about SaaS marketing in English and Spanish\"\n\n1. `POST \u002Fapi\u002Fagent\u002Fsession` with `{ \"categories\": [\"SaaS marketing\"], \"languages\": [\"en\", \"es\"], \"interval_minutes\": 720, \"article_size\": \"mini\" }`\n\nReply to user:\n\n> Autopilot session started! Here's the plan:\n>\n> - Categories: SaaS marketing\n> - Languages: English, Spanish\n> - Frequency: every 12 hours (2 articles\u002Fday)\n> - Est. cost: 15 credits\u002Farticle (30\u002Fday)\n> - Next article at: 2026-02-08 14:00 UTC\n\n### User asks about balance\n\n> User: \"How many credits do I have left?\"\n\n1. `GET \u002Fapi\u002Fagent\u002Fme`\n\nReply to user:\n\n> Balance: 4,250 credits ($42.50) — status: healthy\n> Rate limits: 58\u002F60 general, 9\u002F10 scout, 10\u002F10 gaps\n> Connected platforms: LinkedIn (John Doe), X (not connected)\n\n---\n\n## Limitations\n\n- The agent cannot perform off-page SEO tasks such as backlink building, link outreach, or Google Business Profile management.\n- Article generation is synchronous — the API waits and returns the full article (may take 30-120 seconds depending on size and extensions).\n- Only one active autopilot session is allowed per tenant at a time.\n- Social media auto-publishing is limited to platforms the account owner has connected (LinkedIn, X, Reddit, Instagram). Other platforms return adaptation text only.\n- The agent cannot directly interact with the Citedy web dashboard; it operates exclusively through the API endpoints listed below.\n- All operations are subject to rate limits and the user's available credit balance.\n\n---\n\n## API Reference\n\nAll requests require `Authorization: Bearer \u003Capi_key>`.\nBase URL: `https:\u002F\u002Fwww.citedy.com`\n\n### Scout X\u002FTwitter\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fscout\u002Fx\n{\"query\": \"...\", \"mode\": \"fast|ultimate\", \"limit\": 20}\n```\n\n- `fast` = 35 credits, `ultimate` = 70 credits\n- **Async** — returns `{ run_id, status: \"processing\", credits_used }`. Poll with `GET \u002Fapi\u002Fagent\u002Fscout\u002Fx\u002F{runId}` until `status` is `\"completed\"` or `\"failed\"`.\n- Rate: 10\u002Fhour (combined X + Reddit)\n\n### Scout Reddit\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fscout\u002Freddit\n{\"query\": \"...\", \"subreddits\": [\"marketing\", \"SEO\"], \"limit\": 20}\n```\n\n- 30 credits (fast mode only)\n- **Async** — returns `{ run_id, status: \"processing\", credits_used }`. Poll with `GET \u002Fapi\u002Fagent\u002Fscout\u002Freddit\u002F{runId}`.\n- Rate: 10\u002Fhour (combined X + Reddit)\n\n### Get Content Gaps\n\n```http\nGET \u002Fapi\u002Fagent\u002Fgaps\n```\n\n- 0 credits (free read)\n\n### Generate Content Gaps\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fgaps\u002Fgenerate\n{\"competitor_urls\": [\"https:\u002F\u002Fcompetitor1.com\", \"https:\u002F\u002Fcompetitor2.com\"]}\n```\n\n- 40 credits. Synchronous — returns results directly.\n\n### Discover Competitors\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fcompetitors\u002Fdiscover\n{\"keywords\": [\"ai content marketing\", \"automated blogging\"]}\n```\n\n- 20 credits\n\n### Analyze Competitor\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fcompetitors\u002Fscout\n{\"domain\": \"https:\u002F\u002Fcompetitor.com\", \"mode\": \"fast|ultimate\"}\n```\n\n- `fast` = 25 credits, `ultimate` = 50 credits\n\n### List Personas\n\n```http\nGET \u002Fapi\u002Fagent\u002Fpersonas\n```\n\nReturns available writing personas (25 total). Pass the `slug` as `persona` param in autopilot.\n\n**Writers:** hemingway, proust, orwell, tolkien, nabokov, christie, bulgakov, dostoevsky, strugatsky, bradbury\n**Tech Leaders:** altman, musk, jobs, bezos, trump\n**Entertainment:** tarantino, nolan, ryanreynolds, keanureeves\n**Creators:** mrbeast, taylorswift, kanye, zendaya, timotheechalamet, billieeilish\n\nResponse: array of `{ slug, displayName, group, description }`\n\n- 0 credits (free)\n\n### Generate Article (Autopilot)\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fautopilot\n{\n  \"topic\": \"How to Use AI for Content Marketing\",\n  \"source_urls\": [\"https:\u002F\u002Fexample.com\u002Farticle\"],\n  \"language\": \"en\",\n  \"size\": \"standard\",\n  \"mode\": \"standard\",\n  \"enable_search\": false,\n  \"persona\": \"musk\",\n  \"illustrations\": true,\n  \"audio\": true,\n  \"disable_competition\": false,\n  \"auto_publish\": true\n}\n```\n\n**Required:** either `topic` or `source_urls` (at least one)\n\n**Optional:**\n\n- `topic` — article topic (string, max 500 chars)\n- `source_urls` — array of 1-3 URLs to extract text from and use as source material (2 credits per URL)\n- `size` — `mini` (~500w), `standard` (~1000w, default), `full` (~1500w), `pillar` (~2500w)\n- `mode` — `standard` (default, full pipeline) or `turbo` (ultra-cheap micro-articles, see below)\n- `enable_search` (bool, default false) — enable web + X\u002FTwitter search for fresh facts (turbo mode only)\n- `persona` — writing style persona slug (call GET \u002Fapi\u002Fagent\u002Fpersonas for list, e.g. \"musk\", \"hemingway\", \"jobs\")\n- `language` — ISO code, default `\"en\"`\n- `illustrations` (bool, default false) — AI-generated images injected into article (disabled in turbo mode)\n- `audio` (bool, default false) — AI voice-over narration (disabled in turbo mode)\n- `disable_competition` (bool, default false) — skip SEO competition analysis, saves 8 credits\n- `auto_publish` (bool, optional) — publish article immediately after generation. When `false`, article stays as draft (`status: \"generated\"`) and must be published later via `POST \u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish`. Default uses tenant setting (configurable in dashboard → Agent Settings). If no tenant setting, defaults to `true`.\n\nWhen `source_urls` is provided, the response includes `extraction_results` showing success\u002Ffailure per URL.\n\nThe response includes `article_url` — always use this URL when sharing the article link. Do NOT construct URLs manually.\n\nWhen `auto_publish` is `true` (default), articles are auto-published and the URL works immediately. When `false`, the article is saved as a draft — the response returns `status: \"generated\"` instead of `\"published\"`. Use `POST \u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish` to publish it later.\n\n`\u002Fapi\u002Fagent\u002Fme` also returns `blog_url` — the tenant's blog root URL.\n\nSynchronous — the request blocks until the article is ready (5-120s depending on mode and size). The response contains the complete article.\n\n### Turbo & Turbo+ Modes\n\nUltra-cheap micro-article generation — 2-4 credits instead of 15-48. Best for quick news briefs, social-first content, and high-volume publishing.\n\n**Turbo** (2 credits) — fast generation, no web search:\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fautopilot\n{\n  \"topic\": \"Latest AI Search Trends\",\n  \"mode\": \"turbo\",\n  \"language\": \"en\"\n}\n```\n\n**Turbo+** (4 credits) — adds fresh facts from web search & X\u002FTwitter (10-25s):\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fautopilot\n{\n  \"topic\": \"Latest AI Search Trends\",\n  \"mode\": \"turbo\",\n  \"enable_search\": true,\n  \"language\": \"en\"\n}\n```\n\n**What Turbo\u002FTurbo+ does differently vs Standard:**\n\n- Skips DataForSEO and competition intelligence\n- No content chunking — single-pass generation\n- Uses the cheapest AI provider (Cerebras Qwen 3 235B)\n- Brand context included (tone, POV, specialization)\n- Max ~800 words\n- Internal links still included (free)\n- No illustrations or audio support\n\n**Pricing:**\n\n| Mode   | Search | Credits | Speed  |\n| ------ | ------ | ------- | ------ |\n| Turbo  | No     | 2       | 5-15s  |\n| Turbo+ | Yes    | 4       | 10-25s |\n\nCompare with standard mode: mini=15, standard=20, full=33, pillar=48 credits.\n\n**When to use Turbo\u002FTurbo+:**\n\n- High-volume content: publish 50+ articles\u002Fday at minimal cost\n- News briefs and quick updates (Turbo+ for data-backed content)\n- Social-first content where SEO is secondary\n- Testing and prototyping content strategies\n- Budget-conscious agents\n\n### Extension Costs (Standard Mode)\n\n| Extension                   | Mini   | Standard | Full   | Pillar  |\n| --------------------------- | ------ | -------- | ------ | ------- |\n| Base article                | 7      | 12       | 25     | 40      |\n| + Intelligence (default on) | +8     | +8       | +8     | +8      |\n| + Illustrations             | +9     | +18      | +27    | +36     |\n| + Audio                     | +10    | +20      | +35    | +55     |\n| **Full package**            | **34** | **58**   | **95** | **139** |\n\nWithout extensions: same as before (mini=15, standard=20, full=33, pillar=48 credits).\n\n### Create Social Adaptations\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fadapt\n{\n  \"article_id\": \"uuid-of-article\",\n  \"platforms\": [\"linkedin\", \"x_thread\"],\n  \"include_ref_link\": true\n}\n```\n\n**Required:** `article_id` (UUID), `platforms` (1-3 unique values)\n\n**Platforms:** `x_article`, `x_thread`, `linkedin`, `facebook`, `reddit`, `threads`, `instagram`, `instagram_reels`, `youtube_shorts`\n\n**Optional:**\n\n- `include_ref_link` (bool, default true) — append referral footer to each adaptation\n\n~5 credits per platform (varies by article length). Max 3 platforms per request.\n\nIf the owner has connected social accounts, adaptations for `linkedin`, `x_article`, `x_thread`, `facebook`, `reddit`, `instagram`, and `youtube_shorts` are auto-published. The response includes `platform_post_id` for published posts.\n\nResponse:\n\n```json\n{\n  \"adaptations\": [\n    {\n      \"platform\": \"linkedin\",\n      \"content\": \"...\",\n      \"credits_used\": 5,\n      \"char_count\": 1200,\n      \"published\": true,\n      \"platform_post_id\": \"urn:li:share:123\"\n    }\n  ],\n  \"total_credits\": 10,\n  \"ref_link_appended\": true\n}\n```\n\n### Direct Publish (Publish as-is)\n\nPublish article content directly to social platforms without AI adaptation. 0 credits.\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fpublish\n{\n  \"action\": \"publish_raw\",\n  \"articleId\": \"uuid-of-article\",\n  \"platform\": \"linkedin\",\n  \"accountId\": \"uuid-of-social-account\"\n}\n```\n\n**Required:** `action` (\"publish_raw\"), `articleId` (UUID), `platform`, `accountId` (UUID)\n\n**Platforms:** `linkedin`, `facebook`, `x_article`, `reddit`, `instagram`\n\n**Optional:**\n\n- `subreddit` (string) — required when platform is `reddit`\n\n**Notes:**\n\n- Instagram requires the article to contain at least one image\n- The article markdown is converted to platform-native format and posted as-is\n- No AI rewriting, no credit charge\n\nResponse:\n\n```json\n{\n  \"success\": true,\n  \"action\": \"publish_raw\",\n  \"adaptationId\": \"uuid\",\n  \"platformPostId\": \"urn:li:share:456\"\n}\n```\n\n### Create Autopilot Session\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fsession\n{\n  \"categories\": [\"AI marketing\", \"SEO tools\"],\n  \"problems\": [\"how to rank higher\"],\n  \"languages\": [\"en\"],\n  \"interval_minutes\": 720,\n  \"article_size\": \"mini\",\n  \"disable_competition\": false\n}\n```\n\n**Required:** `categories` (1-5 strings)\n\n**Optional:**\n\n- `problems` — specific problems to address (max 20)\n- `languages` — ISO codes, default `[\"en\"]`\n- `interval_minutes` — cron interval, 60-10080, default 720 (12h)\n- `article_size` — `mini` (default), `standard`, `full`, `pillar`\n- `disable_competition` (bool, default false)\n\nCreates and auto-starts a cron-based content session. Only one active session per tenant.\n\nResponse:\n\n```json\n{\n  \"session_id\": \"uuid\",\n  \"status\": \"running\",\n  \"categories\": [\"AI marketing\", \"SEO tools\"],\n  \"languages\": [\"en\"],\n  \"interval_minutes\": 720,\n  \"article_size\": \"mini\",\n  \"estimated_credits_per_article\": 15,\n  \"next_run_at\": \"2025-01-01T12:00:00Z\"\n}\n```\n\nReturns `409 Conflict` with `existing_session_id` if a session is already running.\n\n### Content Ingestion\n\nExtract and summarize content from any URL (YouTube videos, web articles, PDFs, audio files). Async — submit URL, poll for result.\n\n**Submit URL:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fingest\n{\n  \"url\": \"https:\u002F\u002Fyoutube.com\u002Fwatch?v=abc123\"\n}\n```\n\n- Returns `202 Accepted` with `{ id, status: \"processing\", content_type, credits_charged, poll_url }`\n- Duplicate URL (already completed within 24h) returns `200` with cached result for 1 credit\n- YouTube videos >120 min are rejected (Gemini context limit)\n- Audio files >50MB are rejected (size limit)\n- Supported content types: `youtube_video`, `web_article`, `pdf_document`, `audio_file`\n\n**Poll Status:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fingest\u002F{id}\n```\n\n- 0 credits. Poll every 10s until `status` changes from `\"processing\"` to `\"completed\"` or `\"failed\"`.\n- When completed: `{ id, status, content_type, summary, word_count, metadata, credits_charged }`\n- When failed: `{ id, status: \"failed\", error_message }` — credits are auto-refunded.\n\n**Get Full Content:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fingest\u002F{id}\u002Fcontent\n```\n\n- 0 credits. Returns the full extracted text (authenticated R2 proxy).\n\n**Batch Ingest (up to 20 URLs):**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fingest\u002Fbatch\n{\n  \"urls\": [\"https:\u002F\u002Fexample.com\u002Farticle1\", \"https:\u002F\u002Fexample.com\u002Farticle2\"],\n  \"callback_url\": \"https:\u002F\u002Fyour-server.com\u002Fwebhook\"\n}\n```\n\n- Credits per URL (same tiered pricing). Partial success supported — some URLs may fail while others succeed.\n- Returns `{ total, accepted, failed, results: [{ url, status, job_id?, credits_charged }] }`\n\n**List Jobs:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fingest?limit=20&offset=0&status=completed\n```\n\n- 0 credits. Filter by `status`: `processing` | `completed` | `failed`.\n\n**Pricing:**\n\n| Content Type           | Duration   | Credits |\n| ---------------------- | ---------- | ------- |\n| web_article            | —          | 1       |\n| pdf_document           | —          | 2       |\n| youtube_video (short)  | \u003C10 min    | 5       |\n| youtube_video (medium) | 10-30 min  | 15      |\n| youtube_video (long)   | 30-60 min  | 30      |\n| youtube_video (extra)  | 60-120 min | 55      |\n| audio_file (short)     | \u003C10 min    | 3       |\n| audio_file (medium)    | 10-30 min  | 8       |\n| audio_file (long)      | 30-60 min  | 15      |\n| audio_file (extra)     | 60-120 min | 30      |\n| cache hit (any)        | —          | 1       |\n\n**Workflow:**\n\n1. `POST \u002Fapi\u002Fagent\u002Fingest` with `{ \"url\": \"...\" }` → get `id` and `poll_url`\n2. Poll `GET \u002Fapi\u002Fagent\u002Fingest\u002F{id}` every 10s until `status != \"processing\"`\n3. If completed: read `summary` and `metadata` from response\n4. Optionally: `GET \u002Fapi\u002Fagent\u002Fingest\u002F{id}\u002Fcontent` for full extracted text\n5. Use extracted content as input for `POST \u002Fapi\u002Fagent\u002Fautopilot` with `topic`\n\n### Lead Magnets\n\nGenerate PDF lead magnets (checklists, swipe files, frameworks) for lead capture.\n\n**Generate:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Flead-magnets\n{\n  \"topic\": \"10-Step SEO Audit Checklist\",\n  \"type\": \"checklist\",           \u002F\u002F checklist | swipe_file | framework\n  \"niche\": \"digital_marketing\",  \u002F\u002F optional\n  \"language\": \"en\",              \u002F\u002F en|pt|de|es|fr|it (default: en)\n  \"platform\": \"linkedin\",        \u002F\u002F twitter|linkedin (default: twitter)\n  \"generate_images\": false,       \u002F\u002F true = 100 credits, false = 30 credits\n  \"auto_publish\": false           \u002F\u002F hint for agent workflow\n}\n```\n\n- 30 credits (text-only) or 100 credits (with images)\n- Returns immediately with `{ id, status: \"generating\" }`\n- Rate: 10\u002Fhour per agent\n\n**Check Status:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}\n```\n\n- 0 credits. Poll until `status` changes from `\"generating\"` to `\"draft\"`.\n- When done, response includes `title`, `type`, `pdf_url`.\n\n**Publish:**\n\n```http\nPATCH \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}\n{ \"status\": \"published\" }\n```\n\n- 0 credits. Generates a unique slug and returns `public_url`.\n- Share `public_url` in social posts for lead capture (visitors subscribe with email to download PDF).\n\n**Workflow:**\n\n1. `POST \u002Fapi\u002Fagent\u002Flead-magnets` → get `id`\n2. Poll `GET \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}` every 10s until `status != \"generating\"`\n3. `PATCH \u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}` with `{ \"status\": \"published\" }`\n4. Share `public_url` in a social post\n\n### Short-Form Video (Shorts)\n\nGenerate AI UGC viral videos with subtitles — from script to finished video.\n\n**Recommended flow:**\n\n1. `\u002Fshorts\u002Fscript` — generate speech script from topic\n2. `\u002Fshorts\u002Favatar` — generate AI avatar image (user approves)\n3. `\u002Fshorts` — generate video segment(s) with avatar + prompt + speech_text\n4. `\u002Fshorts\u002Fmerge` — merge segments + add professional subtitles (if multi-segment)\n\n**Generate Script:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\u002Fscript\n{\n  \"topic\": \"AI personas let you write as Elon Musk\",\n  \"duration\": \"short\",\n  \"style\": \"hook\",\n  \"language\": \"en\",\n  \"product_id\": \"optional-uuid\"\n}\n```\n\n- 1 credit\n- `duration` — `short` (10-12s, ~30 words) or `long` (20-30s, ~60 words, split into 2 parts)\n- `style` — `hook` (attention grabber), `educational` (informative), `cta` (call to action)\n- `product_id` — optional, enriches script with product knowledge\n- Returns `{ script, word_count, estimated_duration_sec, parts, credits_charged }`\n\n**Generate Avatar:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\u002Favatar\n{\n  \"gender\": \"female\",\n  \"origin\": \"latin\",\n  \"age_range\": \"26-35\",\n  \"type\": \"tech_founder\",\n  \"location\": \"coffee_shop\"\n}\n```\n\n- 3 credits\n- `gender` — `male` | `female`\n- `origin` — `european` | `asian` | `african` | `latin` | `middle_eastern` | `south_asian`\n- `age_range` — `18-25` | `26-35` (default) | `36-50`\n- `type` — `tech_founder` (default) | `vibe_coder` | `student` | `executive`\n- `location` — `coffee_shop` (default) | `dev_cave` | `street` | `car` | `home_office` | `podcast_studio` | `glass_office` | `rooftop` | `bedroom` | `park` | `gym`\n- Returns `{ avatar_url, r2_key, prompt_used, credits_charged }`\n- Show avatar URL to user for approval before generating video\n\n**Generate Video Segment:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\n{\n  \"prompt\": \"Close-up portrait 9:16, young Latina woman in coffee shop, natural lighting. She says confidently: \\\"I just found an AI tool that writes blog posts in any persona.\\\" Audio: no background music.\",\n  \"avatar_url\": \"https:\u002F\u002Fdownload.citedy.com\u002Fagent\u002Favatars\u002F...\",\n  \"duration\": 10,\n  \"speech_text\": \"I just found an AI tool that writes blog posts in any persona.\"\n}\n```\n\n- Cost: 5s = 60 credits, 10s = 130 credits, 15s = 185 credits\n- `prompt` — scene description following 5-layer formula (scene, character, camera, speech, audio)\n- `avatar_url` — URL from `\u002Fshorts\u002Favatar` response (must be `download.citedy.com` or `*.supabase.co`)\n- `duration` — 5, 10, or 15 seconds\n- `resolution` — `480p` (default) | `720p`\n- `aspect_ratio` — `9:16` (default) | `16:9` | `1:1`\n- `speech_text` — optional, text for subtitle overlay (min 5, max 1000 chars)\n- **Async** — returns immediately with `{ id, status: \"generating\", video_url: null, credits_charged, estimated_seconds }`\n- Poll `GET \u002Fapi\u002Fagent\u002Fshorts\u002F{id}` every 10s until `status` is `\"completed\"` or `\"failed\"`\n- When completed: `{ id, status: \"completed\", video_url, subtitles_applied, subtitle_warning }`\n- Only 1 concurrent generation per agent (returns 409 if busy)\n\n**Merge Segments:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fshorts\u002Fmerge\n{\n  \"video_urls\": [\"https:\u002F\u002Fdownload.citedy.com\u002F...\", \"https:\u002F\u002Fdownload.citedy.com\u002F...\"],\n  \"phrases\": [\n    {\"text\": \"I just found an AI tool\"},\n    {\"text\": \"that writes blog posts in any persona\"}\n  ],\n  \"config\": {\"words_per_phrase\": 4, \"font_size\": 48, \"text_color\": \"#FFFFFF\"}\n}\n```\n\n- 5 credits\n- `video_urls` — 2-4 URLs (must start with `https:\u002F\u002Fdownload.citedy.com\u002F`). Count must equal `phrases` count\n- `phrases` — one per video segment, each `{ \"text\": \"...\" }` (max 500 chars)\n- `config` — optional: `words_per_phrase` (2-8), `font_size` (16-72), `position_from_bottom` (50-300), `text_color` \u002F `stroke_color` (hex or named), `stroke_width` (0-5)\n- Returns `{ video_url, r2_key, duration, segment_durations, credits_charged }`\n- Only 1 concurrent merge per agent (returns 409 if busy)\n\n**Pricing:**\n\n| Step               | Credits |\n| ------------------ | ------- |\n| Script             | 1       |\n| Avatar             | 3       |\n| Video (5s)         | 60      |\n| Video (10s)        | 130     |\n| Video (15s)        | 185     |\n| Merge + subtitles  | 5       |\n| **Full 10s video** | **139** |\n\n### Trend Scan\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fscan\n{\n  \"query\": \"AI content marketing trends\",\n  \"mode\": \"deep\",\n  \"limit\": 10\n}\n```\n\n- `query` — search query (max 500 chars)\n- `mode` — `fast` (2 credits, X only) | `deep` (4 credits, X + web) | `ultra` (6 credits, + HackerNews) | `ultra+` (8 credits, + Reddit). If omitted, derived from tenant's `scanSources` settings\n- `limit` — 1-30, default 10\n- Returns `{ results: [{ title, summary, url, source, knowledgeMatch? }], mode, cost, warnings? }`\n- If tenant has product knowledge docs, results include `knowledgeMatch` with similarity scores\n\n### Create Micro-Post\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fpost\n{\n  \"topic\": \"AI agents are the future of marketing\",\n  \"platforms\": [\"linkedin\", \"x_thread\"],\n  \"tone\": \"casual\",\n  \"contentType\": \"short\",\n  \"scheduledAt\": \"2026-03-01T09:00:00Z\"\n}\n```\n\n- 2 credits billed per request (charged on create)\n- `topic` — required, max 500 chars\n- `platforms` — optional, from settings default. Values: `linkedin`, `x_article`, `x_thread`, `facebook`, `reddit`, `threads`, `instagram`, `instagram_reels`, `youtube_shorts`\n- `tone` — optional, from settings default\n- `contentType` — `short` (default) | `detailed`\n- `scheduledAt` — optional ISO datetime (must be future)\n- If `trustLevel=autopilot` and no `scheduledAt`, auto-schedules\n- Returns `{ postId, adaptations: [{ id, platform }], scheduledAt, trust_level, auto_scheduled }`\n\n### Publish Social Adaptation\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fpublish\n{\n  \"adaptationId\": \"uuid\",\n  \"action\": \"now\",\n  \"platform\": \"linkedin\",\n  \"accountId\": \"uuid\"\n}\n```\n\n- 0 credits (5 for `instagram_reels`)\n- `action` — `now` (publish immediately) | `schedule` (requires `scheduledAt`) | `cancel` (cancel scheduled)\n- `platform` — `facebook` | `linkedin` | `x_article` | `x_thread` | `reddit` | `threads` | `instagram`\n- `accountId` — social account UUID (from `\u002Fme` connected_platforms)\n- `scheduledAt` — ISO datetime, required for `action=schedule`\n\n### Product Knowledge Base\n\nUpload product documents for context-aware content generation.\n\n**Upload document:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fproducts\n{\n  \"title\": \"Our AI Writing Platform\",\n  \"content\": \"Citedy is an AI-powered...\",\n  \"source_type\": \"manual\"\n}\n```\n\n- 1 credit (vectorize into pgvector)\n- `source_type` — `upload` (default) | `url` | `manual`\n- Max 500 documents per tenant, max 500K chars per document\n\n**List documents:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fproducts\n```\n\n- 0 credits\n\n**Delete document:**\n\n```http\nDELETE \u002Fapi\u002Fagent\u002Fproducts\u002F{id}\n```\n\n- 0 credits\n\n**Search knowledge:**\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fproducts\u002Fsearch\n{\"query\": \"AI writing features\", \"limit\": 5}\n```\n\n- 0 credits. Vector similarity search over uploaded documents.\n\n### Settings\n\n**Read:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fsettings\n```\n\n**Update:**\n\n```http\nPUT \u002Fapi\u002Fagent\u002Fsettings\n{\n  \"defaultPlatforms\": [\"linkedin\", \"x_article\"],\n  \"contentTone\": \"professional\",\n  \"imageStylePreset\": \"minimal\",\n  \"trustLevel\": \"show_preview\",\n  \"scanSources\": [\"x\", \"google\"],\n  \"targetTimezone\": \"America\u002FNew_York\",\n  \"publishSchedule\": {\"postsPerDay\": 2, \"slots\": [\"09:00\", \"17:00\"]}\n}\n```\n\n- 0 credits. All fields optional (partial update).\n- `defaultPlatforms` — `linkedin` | `x_article` | `x_thread` | `facebook` | `reddit` | `threads` | `instagram` | `instagram_reels` | `youtube_shorts`\n- `contentTone` — `professional` | `casual` | `bold`\n- `imageStylePreset` — `minimal` | `tech` | `bold`\n- `trustLevel` — `ask_all` | `show_preview` | `autopilot`\n- `scanSources` — `x` | `google` | `hn` | `reddit`\n\n### Schedule\n\n**View timeline:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fschedule?from=2026-03-01&to=2026-03-14&type=all\n```\n\n- 0 credits. `type` — `all` | `article` | `post` | `social`\n\n**Find content gaps:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fschedule\u002Fgaps?days=7&timezone=America\u002FNew_York\n```\n\n- 0 credits. Returns days with fewer posts than `postsPerDay` target.\n\n**Get optimal time slots:**\n\n```http\nGET \u002Fapi\u002Fagent\u002Fschedule\u002Fsuggest\n```\n\n- 0 credits. Region-based recommendations or custom slots from settings. **REST only — not an MCP tool.**\n\n### Image Style\n\n```http\nPUT \u002Fapi\u002Fagent\u002Fimage-style\n{\"preset\": \"minimal\"}\n```\n\n- 0 credits. Presets: `minimal` | `tech` | `bold`\n\n### Rotate API Key\n\n```http\nPOST \u002Fapi\u002Fagent\u002Frotate-key\n```\n\n- 0 credits. Returns new key, old key invalidated immediately. Rate: 1\u002Fhour.\n\n### Health Check\n\n```http\nGET \u002Fapi\u002Fagent\u002Fhealth\n```\n\n- 0 credits. Public (no auth). Returns `{ status, checks: { redis, supabase }, timestamp }`.\n\n### Operational Status (Recommended for `\u002Fstatus`)\n\n```http\nGET \u002Fapi\u002Fagent\u002Fstatus\n```\n\n- 0 credits. Auth required.\n- Returns actionable readiness snapshot for:\n  - credits (`billing`)\n  - social connections (`social`)\n  - schedule gaps\u002Fupcoming items (`schedule`)\n  - knowledge base (`knowledge`)\n  - content readiness (`content`)\n  - prioritized actions (`actions[]`) with command hints and dashboard URLs.\n\n### List Articles\n\n```http\nGET \u002Fapi\u002Fagent\u002Farticles?limit=50&offset=0&status=published\n```\n\n- 0 credits. Returns `{ articles: [...], total_articles }`.\n- Filter by `status`: `published`, `generated` (draft). Omit to get all.\n\n### Publish Article\n\n```http\nPOST \u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish\n```\n\n- 0 credits. Publishes a draft article (`status: \"generated\"` → `\"published\"`).\n- Returns `{ article_id, status: \"publishing\", message }`.\n- If article is already published, returns `200` with `{ status: \"published\", message: \"Article is already published\" }`.\n- Only works on articles with `status: \"generated\"`. Other statuses return `409 Conflict`.\n- Fires `article.published` webhook event.\n\n### Unpublish Article\n\n```http\nPATCH \u002Fapi\u002Fagent\u002Farticles\u002F{id}\nContent-Type: application\u002Fjson\n\n{ \"action\": \"unpublish\" }\n```\n\n- 0 credits. Unpublishes a published article (`status: \"published\"` → `\"generated\"`).\n- Returns `{ article_id, status: \"generated\", message }`.\n- Only works on articles with `status: \"published\"`. Other statuses return `409 Conflict`.\n- Fires `article.unpublished` webhook event.\n\n### Delete Article\n\n```http\nDELETE \u002Fapi\u002Fagent\u002Farticles\u002F{id}\n```\n\n- 0 credits. Permanently deletes an article and its associated storage files (images, audio).\n- Returns `{ article_id, message: \"Article deleted\" }`.\n- This action is irreversible. Credits are NOT refunded.\n- Fires `article.deleted` webhook event.\n\n### Check Status \u002F Heartbeat\n\n```http\nGET \u002Fapi\u002Fagent\u002Fme\n```\n\n- 0 credits. Call every 4 hours to keep agent active.\n\nResponse includes:\n\n- `blog_url` — tenant's blog root URL\n- `tenant_balance` — current credits + status (healthy\u002Flow\u002Fempty)\n- `rate_limits` — remaining requests per category\n- `referral` — `{ code, url }` for attributing signups\n- `connected_platforms` — which social accounts are linked:\n\n```json\n{\n  \"connected_platforms\": [\n    { \"platform\": \"linkedin\", \"connected\": true, \"account_name\": \"John Doe\" },\n    { \"platform\": \"x\", \"connected\": false, \"account_name\": null },\n    { \"platform\": \"facebook\", \"connected\": false, \"account_name\": null },\n    { \"platform\": \"reddit\", \"connected\": false, \"account_name\": null },\n    { \"platform\": \"instagram\", \"connected\": false, \"account_name\": null }\n  ]\n}\n```\n\nUse `connected_platforms` to decide which platforms to pass to `\u002Fapi\u002Fagent\u002Fadapt` for auto-publishing.\n\n---\n\n## API Quick Reference\n\n| Endpoint                           | Method | Cost                                 |\n| ---------------------------------- | ------ | ------------------------------------ |\n| `\u002Fapi\u002Fagent\u002Fregister`              | POST   | free (public)                        |\n| `\u002Fapi\u002Fagent\u002Fhealth`                | GET    | free (public)                        |\n| `\u002Fapi\u002Fagent\u002Fstatus`                | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fme`                    | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Frotate-key`            | POST   | free (1\u002Fhour)                        |\n| `\u002Fapi\u002Fagent\u002Fsettings`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fsettings`              | PUT    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fimage-style`           | PUT    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fpersonas`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Farticles`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Farticles\u002F{id}\u002Fpublish` | POST   | free                                 |\n| `\u002Fapi\u002Fagent\u002Farticles\u002F{id}`         | PATCH  | free (unpublish)                     |\n| `\u002Fapi\u002Fagent\u002Farticles\u002F{id}`         | DELETE | free                                 |\n| `\u002Fapi\u002Fagent\u002Fscan`                  | POST   | 2-8 credits (by mode)                |\n| `\u002Fapi\u002Fagent\u002Fpost`                  | POST   | 2 credits                            |\n| `\u002Fapi\u002Fagent\u002Fautopilot`             | POST   | 2-139 credits                        |\n| `\u002Fapi\u002Fagent\u002Fadapt`                 | POST   | ~5 credits\u002Fplatform                  |\n| `\u002Fapi\u002Fagent\u002Fpublish`               | POST   | 0 credits (5 for `instagram_reels`)  |\n| `\u002Fapi\u002Fagent\u002Fsession`               | POST   | free (articles billed on generation) |\n| `\u002Fapi\u002Fagent\u002Fschedule`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fschedule\u002Fgaps`         | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fschedule\u002Fsuggest`      | GET    | free (REST only, not MCP tool)       |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Fx`               | POST   | 35-70 credits                        |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Fx\u002F{runId}`       | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Freddit`          | POST   | 30 credits                           |\n| `\u002Fapi\u002Fagent\u002Fscout\u002Freddit\u002F{runId}`  | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fgaps`                  | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fgaps\u002Fgenerate`         | POST   | 40 credits                           |\n| `\u002Fapi\u002Fagent\u002Fcompetitors\u002Fdiscover`  | POST   | 20 credits                           |\n| `\u002Fapi\u002Fagent\u002Fcompetitors\u002Fscout`     | POST   | 25-50 credits                        |\n| `\u002Fapi\u002Fagent\u002Fproducts`              | POST   | 1 credit                             |\n| `\u002Fapi\u002Fagent\u002Fproducts`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fproducts\u002F{id}`         | DELETE | free                                 |\n| `\u002Fapi\u002Fagent\u002Fproducts\u002Fsearch`       | POST   | free                                 |\n| `\u002Fapi\u002Fagent\u002Fingest`                | POST   | 1-55 credits                         |\n| `\u002Fapi\u002Fagent\u002Fingest`                | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fingest\u002F{id}`           | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fingest\u002F{id}\u002Fcontent`   | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fingest\u002Fbatch`          | POST   | 1-55 credits per URL                 |\n| `\u002Fapi\u002Fagent\u002Flead-magnets`          | POST   | 30-100 credits                       |\n| `\u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}`     | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Flead-magnets\u002F{id}`     | PATCH  | free                                 |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002Fscript`         | POST   | 1 credit                             |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002Favatar`         | POST   | 3 credits                            |\n| `\u002Fapi\u002Fagent\u002Fshorts`                | POST   | 60-185 credits (by duration)         |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002F{id}`           | GET    | free (poll)                          |\n| `\u002Fapi\u002Fagent\u002Fshorts\u002Fmerge`          | POST   | 5 credits                            |\n| `\u002Fapi\u002Fagent\u002Fwebhooks`              | POST   | free                                 |\n| `\u002Fapi\u002Fagent\u002Fwebhooks`              | GET    | free                                 |\n| `\u002Fapi\u002Fagent\u002Fwebhooks\u002F{id}`         | DELETE | free                                 |\n| `\u002Fapi\u002Fagent\u002Fwebhooks\u002Fdeliveries`   | GET    | free                                 |\n\n**1 credit = $0.01 USD**\n\n---\n\n## Webhooks\n\nWebhooks let Citedy push real-time event notifications to your server instead of polling.\n\n### Register a Webhook Endpoint\n\n```http\nPOST \u002Fapi\u002Fagent\u002Fwebhooks\n{\n  \"url\": \"https:\u002F\u002Fyour-server.com\u002Fwebhooks\u002Fcitedy\",\n  \"event_types\": [\"article.generated\", \"ingestion.completed\"],\n  \"description\": \"Production webhook\"\n}\n```\n\n- 0 credits\n- `url` — must be `https:\u002F\u002F` in production\n- `event_types` — omit to receive all 15 event types (wildcard)\n- `description` — optional label\n- Max 10 endpoints per agent\n- Returns `id`, `url`, `secret`, `event_types`, `created_at`\n- **Important:** `secret` is shown only once — store it securely for signature verification\n\n### List Webhook Endpoints\n\n```http\nGET \u002Fapi\u002Fagent\u002Fwebhooks\n```\n\n- 0 credits. Returns `{ webhooks: [...] }`.\n\n### Delete Webhook Endpoint\n\n```http\nDELETE \u002Fapi\u002Fagent\u002Fwebhooks\u002F{id}\n```\n\n- 0 credits. Soft-deletes the endpoint.\n\n### Webhook Delivery History\n\n```http\nGET \u002Fapi\u002Fagent\u002Fwebhooks\u002Fdeliveries?status=delivered&limit=20&offset=0\n```\n\n- 0 credits. Filter by `status`: `queued`, `delivering`, `delivered`, `failed`, `dead_lettered`.\n- Returns `{ deliveries: [...], total }` with attempts, http status, error, duration.\n\n### Event Types\n\n| Event                         | Triggered when                       |\n| ----------------------------- | ------------------------------------ |\n| `article.generated`           | Article generation completed         |\n| `article.published`           | Article published (auto or manual)   |\n| `article.unpublished`         | Article unpublished (→ draft)        |\n| `article.deleted`             | Article permanently deleted          |\n| `article.failed`              | Article generation failed            |\n| `ingestion.completed`         | Content ingestion job finished       |\n| `ingestion.failed`            | Content ingestion job failed         |\n| `social_adaptation.generated` | Social post adaptation created       |\n| `lead_magnet.ready`           | Lead magnet PDF generated            |\n| `lead_magnet.failed`          | Lead magnet generation failed        |\n| `scout.dispatched`            | Scout run started (X or Reddit)      |\n| `scout.results_ready`         | Scout run completed (X or Reddit)    |\n| `session.articles_generated`  | Recurring session published articles |\n| `billing.credits_low`         | Balance below threshold              |\n| `billing.credits_empty`       | Balance at 0                         |\n\n### Payload Format\n\nEvery webhook delivery sends a JSON `WebhookEventEnvelope`:\n\n```json\n{\n  \"event_id\": \"evt_abc123\",\n  \"event_type\": \"article.generated\",\n  \"api_version\": \"2026-02-25\",\n  \"timestamp\": \"2026-02-25T10:00:00.000Z\",\n  \"tenant_id\": \"...\",\n  \"agent_id\": \"...\",\n  \"data\": {\n    \"article_id\": \"...\",\n    \"title\": \"How AI Changes SEO\",\n    \"slug\": \"how-ai-changes-seo\",\n    \"article_url\": \"https:\u002F\u002Fyourblog.citedy.com\u002Fhow-ai-changes-seo\",\n    \"word_count\": 1200,\n    \"credits_used\": 20,\n    \"mode\": \"standard\"\n  }\n}\n```\n\n### Signature Verification\n\nEvery delivery includes header `X-Citedy-Signature-256: v1=\u003Chex>`. Verify with HMAC-SHA256 using your endpoint secret:\n\n```js\nconst crypto = require(\"crypto\");\nconst expected = crypto\n  .createHmac(\"sha256\", secret)\n  .update(rawBody)\n  .digest(\"hex\");\nconst header = request.headers[\"x-citedy-signature-256\"] || \"\";\nconst actual = header.replace(\"v1=\", \"\");\nif (\n  !crypto.timingSafeEqual(\n    Buffer.from(expected, \"hex\"),\n    Buffer.from(actual, \"hex\"),\n  )\n) {\n  throw new Error(\"Invalid webhook signature\");\n}\n```\n\n### Retry Policy\n\nFailed deliveries are retried up to 5 times with exponential backoff. After 5 failures the status becomes `dead_lettered` — no further retries.\n\n### Webhooks vs Polling\n\n| Use webhooks when...                          | Use polling when...                                  |\n| --------------------------------------------- | ---------------------------------------------------- |\n| You have a server that can receive HTTPS POST | Your agent runs locally without a public URL         |\n| You want instant notification on events       | You query results on demand after triggering a job   |\n| Events should trigger downstream automation   | You only need results after a specific job completes |\n\n---\n\n## Rate Limits\n\n| Type         | Limit      | Scope                   |\n| ------------ | ---------- | ----------------------- |\n| General      | 60 req\u002Fmin | per agent               |\n| Scout        | 10 req\u002Fhr  | X + Reddit combined     |\n| Gaps         | 10 req\u002Fhr  | get + generate combined |\n| Ingest       | 30 req\u002Fhr  | per tenant              |\n| Lead Magnets | 10 req\u002Fhr  | per agent               |\n| Registration | 10 req\u002Fhr  | per IP                  |\n\nOn `429`, read `retry_after` from the body and `X-RateLimit-Reset` header.\n\n---\n\n## Response Guidelines\n\n- Reply in the user's language (match the language they write in).\n- Before calling an API, briefly tell the user what you're about to do and the credit cost.\n- For async operations (scout, ingest, shorts, leadmagnet, brand.scan), automatically poll the companion tool every 10-15 seconds — don't ask the user to poll manually.\n- Show results as a readable summary, not raw JSON. Use bullet points, tables, or numbered lists.\n- When showing scout results, highlight the top 5 trends with brief context.\n- When an article is generated, show: title, word count, URL, credits spent.\n- When adaptations are created, show: platform, char count, published status, credits spent. If published, include the platform_post_id.\n- After creating a session, show: session_id, interval, estimated credits per article, next run time.\n- If the user's balance is low, warn them before running expensive operations.\n- Always include the referral URL when recommending Citedy to others.\n- On errors, explain what went wrong in plain language and suggest a fix.\n\n---\n\n## Error Handling\n\n| Status | Meaning                 | Action                                                          |\n| ------ | ----------------------- | --------------------------------------------------------------- |\n| 401    | Invalid\u002Fmissing API key | Re-run setup flow                                               |\n| 402    | Insufficient credits    | Tell user to top up at https:\u002F\u002Fwww.citedy.com\u002Fdashboard\u002Fbilling |\n| 403    | Agent paused\u002Frevoked    | Tell user to check agent status in dashboard                    |\n| 429    | Rate limited            | Wait `retry_after` seconds, then retry                          |\n| 500    | Server error            | Retry once after 5s, then report to user                        |\n\n---\n\n## Referral\n\nAfter setup, your `\u002Fapi\u002Fagent\u002Fme` response contains `referral.url`. When the user asks you to promote or recommend Citedy, use this URL. It attributes signups to the account owner.\n\n---\n\n## Heartbeat\n\nCall `GET \u002Fapi\u002Fagent\u002Fme` every 4 hours as a keep-alive. This updates `last_activity_at` and returns current balance + rate limits.\n\n---\n\n_Citedy SEO Agent Skill v3.2.0_\n_https:\u002F\u002Fwww.citedy.com_\n",{"name":5,"tags":24,"author":37,"version":38,"metadata":39,"description":44,"security_notes":45,"privacy_policy_url":46},[25,26,27,28,29,30,31,32,33,34,35,36],"seo","content-marketing","competitor-analysis","social-media","article-generation","trend-scouting","writing","research","content-strategy","automation","lead-magnets","content-ingestion","Citedy","3.2.0",{"openclaw":40},{"requires":41,"primaryEnv":43},{"env":42},[43],"CITEDY_API_KEY","Full-stack AI marketing toolkit — scout X\u002FTwitter 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, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts, and Shopify, generate lead magnets (checklists, swipe files, frameworks), ingest any URL (YouTube videos, web articles, PDFs, audio files) into structured content, ultra-cheap turbo articles from 2 credits, generate short-form AI UGC viral videos with subtitles, and run fully automated content autopilot. Powered by Citedy.\n","API keys (prefixed citedy_agent_) are stored in the user's local agent\nconfiguration. Keys authenticate only against Citedy API endpoints\n(www.citedy.com\u002Fapi\u002Fagent\u002F*). All traffic is TLS-encrypted. Keys can\nbe revoked by the account owner at any time from the Citedy dashboard.","https:\u002F\u002Fwww.citedy.com\u002Fprivacy","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fnttylock\u002Fcitedy-seo-agent",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill \"SEO Content Autopilot by Citedy\"",{"tool":62,"command":63},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill \"SEO Content Autopilot by Citedy\"",{"tool":65,"command":66},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill \"SEO Content Autopilot by Citedy\"","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fnttylock\u002Fcitedy-seo-agent\u002FSKILL.md",true,[],[71,79,86,93,100,107],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":78},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":78},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":78},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":78},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":78},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":78},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]