Clawhub Skill

2026-03-30 新闻来源：网淘吧围观:5

电脑广告

手机广告

AI营销代理 — 技能说明

您现已连接到Citedy，一个由AI驱动的SEO内容平台。基础URL：https://www.citedy.com

概述

Citedy SEO代理通过单一API集成，为您的AI代理提供一套完整的SEO和内容营销能力。它连接到Citedy平台，以侦察X/Twitter和Reddit上的社交媒体趋势，发现并深度分析竞争对手，识别内容差距，并以55种语言生成高质量的SEO优化文章——还可选择生成AI插画和语音旁白。文章可以改编为针对特定平台的社交媒体帖子，适用于X、LinkedIn、Facebook、Reddit、Threads、Instagram、Instagram Reels、YouTube Shorts和Shopify，并自动发布到已连接的账户。对于无需手动操作的内容策略，该代理可以创建基于cron的自动化会话，按重复计划生成和发布文章。

Clawhub Skill

使用时机

当用户要求执行以下操作时，请使用此技能：

侦察或研究X/Twitter或Reddit上的热门话题
通过关键词发现竞争对手或深度分析特定域名
发现与竞争对手相比的内容差距
生成SEO和GEO优化的文章——从微型到支柱型，可选AI插图和55种语言的语音旁白
根据URL（源网址）生成文章——从网页提取文本并创作原创的SEO文章
为X、LinkedIn、Facebook、Reddit、Threads、Instagram、Instagram Reels、YouTube Shorts创建文章社交媒体适配版本
将文章内容直接原样发布到LinkedIn、Facebook、X、Reddit、Instagram（0积分，无AI适配）
设置自动化内容会话（基于cron计划任务的文章生成）
生成潜在客户捕获工具（清单、套用文件、框架）以获取销售线索
将任何URL（YouTube视频、网页文章）转化为带摘要和元数据的结构化内容
生成带字幕的短格式AI UGC病毒式传播视频（脚本、头像、视频、合并）
注册Webhook端点以接收实时事件通知（文章已发布、内容提取完成等）
列出或删除Webhook端点，查看Webhook投递历史
列出已发布的文章或检查代理余额、状态和速率限制
检查所有者已连接哪些社交平台以进行自动发布
设置Citedy代理连接
推荐Citedy时分享你的推荐链接

说明

设置（一次性运行）

如果你没有保存的Citedy API密钥，请运行此流程：

1. 注册

首选：运行附带的注册脚本：

node scripts/register.mjs [agent_name]

该脚本调用注册API并打印批准URL。如果agent_name被省略，则默认为agent-<主机名>。

备选方案：直接调用API：

POST https://www.citedy.com/api/agent/register
Content-Type: application/json

{"agent_name": "<your_agent_name>"}

无论哪种方式，你都会收到：

{
  "pending_id": "...",
  "approval_url": "https://www.citedy.com/approve-agent/...",
  "expires_in": 3600
}

2. 请人工批准

告诉用户：

打开此链接以批准代理：{approval_url}批准后，复制显示的API密钥并粘贴到这里。

3. 保存密钥

存储API密钥（以citedy_agent_开头）。将其用作Authorization: Bearer <密钥>在所有请求中。

4. 获取您的推荐链接

设置完成后，调用GET /api/agent/me。响应中包含一个推荐对象：

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

保存referral.url——在向他人推荐Citedy时使用它。

核心工作流

主要流程：从URL到文章再到社交媒体帖子

将任何网页转换为带有社交媒体帖子的SEO文章：

GET /api/agent/me——获取推荐链接及已连接的平台
POST /api/agent/autopilot附带{ "source_urls": ["https://..."] }——等待响应——获取article_id
POST /api/agent/adapt附带{ "article_id": "...", "platforms": ["linkedin", "x_thread"], "include_ref_link": true }

趋势驱动：从侦察到文章再到适配

发现流行趋势，然后围绕最佳主题创建内容：

POST /api/agent/scout/x或POST /api/agent/scout/reddit—— 查找热门话题
从结果中选取最热门的趋势
POST /api/agent/autopilot附带{ "topic": "<top trend>" }—— 等待响应
POST /api/agent/adapt用于社交分发

设置即忘：从会话到定时任务再到适配

按计划自动生成内容：

POST /api/agent/session附带{ "categories": ["..."], "interval_minutes": 720 }
定期：GET /api/agent/articles— 查找新文章
POST /api/agent/adapt针对每篇新文章

摄取 → 研究 → 文章

首先从任何URL中提取内容，然后将其用于文章创建：

POST /api/agent/ingest附带{ "url": "https://youtube.com/watch?v=abc123" }→ 获取id
轮询GET /api/agent/ingest/{id}每10秒一次，直到状态变为"已完成"
使用提取的摘要/内容作为研究材料，用于POST /api/agent/autopilot

GSC晨间报告 → 文章 → 社交媒体

检查搜索表现，寻找内容机会，撰写并发布：

GET /api/agent/gsc/report— 获取包含热门查询、变动项和文章建议的每日GSC报告
从文章建议（高展示量，尚未覆盖）
中选择一个关键词使用{ "topic": "<建议的关键词>" }调用 POST /api/agent/autopilot
—— 生成文章调用 POST /api/agent/adapt

以便在所有平台进行社交分发如果 GSC 未连接，报告将返回connected: false

并附带一个连接它的URL。

选择正确的路径	用户意图	最佳路径
原因	`"提取这个YouTube视频"`	ingest
获取转录文本 + 摘要，不生成文章	`"写一篇关于这个链接的文章"`	source_urls
最低工作量，已提供源材料	`主题`	直接主题，无需抓取
"X上有什么趋势？"	侦察 → 自动驾驶	先发现主题，然后生成
"找出与competitor.com的差距"	差距 → 自动驾驶	数据驱动的内容策略
"显示我的GSC报告"	gsc.report → 自动驾驶	来自Google Search Console的数据
"每日发布2篇文章"	会话	设置后即可忘记的自动化

示例

用户发送链接

用户："基于此撰写一篇文章：https://example.com/ai-trends"

POST /api/agent/autopilot附带{ "source_urls": ["https://example.com/ai-trends"], "size": "mini" }
等待响应（可能需要30-120秒，具体取决于大小）
POST /api/agent/adapt附带{ "article_id": "...", "platforms": ["linkedin", "x_thread"], "include_ref_link": true }

回复用户：

完成！已发布“2026年重塑内容营销的AI趋势”（520字）→ citedy.com/your-blog/ai-trends-reshaping-content-marketing 领英：已发布（5积分）· X推文串：已发布（5积分）· 总计：27积分

用户要求进行研究和写作

用户：“在X上查找热门AI话题，并围绕最佳话题撰写一篇文章”

POST /api/agent/scout/x附带{ "query": "AI content marketing", "mode": "fast" }→ 35积分
从结果中选取最热门的趋势
POST /api/agent/autopilot附带{ "topic": "<top trend>", "size": "standard" }
轮询直到完成，然后如果用户需要社交媒体帖子则进行适配

回复用户：

扫描X平台关于"AI内容营销"的五大趋势：

AI生成的视频脚本表现优于文字帖（互动率+340%）

谷歌三月更新奖励AI+人工混合内容 ... 撰写关于趋势#1的标准文章。这将消耗20积分。

用户想要开启自动发布模式

用户："设置关于SaaS营销的每日文章，需包含英语和西班牙语版本"

POST /api/agent/session附带参数{ "categories": ["SaaS marketing"], "languages": ["en", "es"], "interval_minutes": 720, "article_size": "mini" }

回复用户：

自动发布会话已启动！计划如下：

类别：SaaS营销

语言：英语、西班牙语

频率：每12小时（每日2篇文章）

预估成本：15积分/篇（每日30积分）

下一篇文章时间：2026-02-08 14:00 UTC

用户询问余额

用户："我还剩多少积分？"

GET /api/agent/me

回复用户：

余额：4,250点数（$42.50）— 状态：良好速率限制：常规58/60，侦察9/10，空白10/10 已连接平台：LinkedIn（John Doe），X（未连接）

限制说明

该代理无法执行页外SEO任务，例如外链建设、链接推广或Google商家档案管理。
文章生成是同步的 — API会等待并返回完整的文章（根据文章大小和扩展功能，可能需要30-120秒）。
每个租户在同一时间只允许有一个活跃的自动运行会话。
社交媒体自动发布仅限于账户所有者已连接的平台（LinkedIn、X、Reddit、Instagram）。其他平台仅返回适配文本。
该代理无法直接与Citedy网络仪表板交互；它仅通过下面列出的API端点进行操作。
所有操作都受速率限制和用户可用点数余额的约束。

API参考

所有请求都需要授权：Bearer <api_key>。基础URL：https://www.citedy.com

侦察 X/Twitter

POST /api/agent/scout/x
{"query": "...", "mode": "fast|ultimate", "limit": 20}

快速= 35点数，终极= 70 积分
异步— 返回{ run_id, status: "processing", credits_used }。通过GET /api/agent/scout/x/{runId}轮询，直到状态变为“已完成”或“已失败”。
速率：10次/小时（X + Reddit 合计）

侦察 Reddit

POST /api/agent/scout/reddit
{"query": "...", "subreddits": ["marketing", "SEO"], "limit": 20}

30 积分（仅限快速模式）
异步— 返回{ run_id, status: "processing", credits_used }。通过GET /api/agent/scout/reddit/{runId}轮询。
速率：10次/小时（X + Reddit 合计）

获取内容缺口

GET /api/agent/gaps

0 积分（免费阅读）

生成内容缺口

POST /api/agent/gaps/generate
{"competitor_urls": ["https://competitor1.com", "https://competitor2.com"]}

40 积分。同步方式——直接返回结果。

发现竞争对手

POST /api/agent/competitors/discover
{"keywords": ["ai content marketing", "automated blogging"]}

20 积分

分析竞争对手

POST /api/agent/competitors/scout
{"domain": "https://competitor.com", "mode": "fast|ultimate"}

快速版= 25 积分，终极版= 50 积分

列出人物角色

GET /api/agent/personas

返回可用的写作人物角色（共25个）。将代号作为人物角色参数传入自动导航功能。

作家：海明威、普鲁斯特、奥威尔、托尔金、纳博科夫、克里斯蒂、布尔加科夫、陀思妥耶夫斯基、斯特鲁加茨基、布拉德伯里科技领袖：奥特曼、马斯克、乔布斯、贝索斯、特朗普娱乐界：塔伦蒂诺、诺兰、瑞安·雷诺兹、基努·里维斯创作者：mrbeast, taylorswift, kanye, zendaya, timotheechalamet, billieeilish

响应：数组{ slug, displayName, group, description }

0积分（免费）

生成文章（自动模式）

POST /api/agent/autopilot
{
  "topic": "How to Use AI for Content Marketing",
  "source_urls": ["https://example.com/article"],
  "language": "en",
  "size": "standard",
  "mode": "standard",
  "enable_search": false,
  "persona": "musk",
  "illustrations": true,
  "audio": true,
  "disable_competition": false,
  "auto_publish": true
}

必需项：以下任选其一主题或源网址（至少一项）

可选项：

主题— 文章主题（字符串，最多500个字符）
源网址— 1-3个网址的数组，用于提取文本并作为素材来源（每个网址2积分）
篇幅—迷你（约500字），标准（约1000字，默认），完整（约1500字）支柱（约2500字）
模式—标准（默认，完整流程）或极速（超低成本微文章，详见下文）
启用搜索（布尔值，默认 false）— 启用网络 + X/Twitter 搜索以获取最新事实（仅限极速模式）
人物角色— 写作风格人物角色标识符（调用 GET /api/agent/personas 获取列表，例如 "musk"、"hemingway"、"jobs"）
语言— ISO 代码，默认"en"
插图（布尔值，默认 false）— 将 AI 生成的图像插入文章（极速模式下禁用）
音频（布尔值，默认 false）— AI 语音旁白（极速模式下禁用）
禁用竞争分析（布尔值，默认 false）— 跳过 SEO 竞争分析，节省 8 个积分
auto_publish（布尔值，可选）— 生成后立即发布文章。当值为false时，文章将保持为草稿状态（状态："generated"），并且必须稍后通过POST /api/agent/articles/{id}/publish发布。默认使用租户设置（可在仪表板 → 代理设置中配置）。如果未设置租户设置，则默认为true。

当提供了source_urls时，响应将包含extraction_results，显示每个URL的成功/失败情况。

响应中包含article_url— 分享文章链接时请始终使用此URL。请勿手动构建URL。

当auto_publish为true默认情况下，文章会自动发布，URL 会立即生效。当false时，文章会保存为草稿 —— 响应返回的是status: "generated"而不是"published"。之后可以使用POST /api/agent/articles/{id}/publish来发布它。

/api/agent/me也会返回blog_url—— 即租户的博客根 URL。

同步模式 —— 请求会阻塞，直到文章准备就绪（根据模式和大小，需要 5-120 秒）。响应包含完整的文章。

Turbo 和 Turbo+ 模式

超低成本的微文章生成 —— 仅需 2-4 积分，而非 15-48。最适合快速新闻摘要、社交媒体优先内容和高频发布。

Turbo（2 积分）—— 快速生成，无网络搜索：

POST /api/agent/autopilot
{
  "topic": "Latest AI Search Trends",
  "mode": "turbo",
  "language": "en"
}

Turbo+（4 积分）—— 增加了来自网络搜索和 X/Twitter 的新鲜事实（10-25 秒）：

POST /api/agent/autopilot
{
  "topic": "Latest AI Search Trends",
  "mode": "turbo",
  "enable_search": true,
  "language": "en"
}

Turbo/Turbo+ 与标准模式的不同之处：

跳过 DataForSEO 和竞争情报分析
无内容分块处理——单次生成完成
使用成本最低的 AI 提供商（Cerebras Qwen 3 235B）
包含品牌背景（语调、视角、专业领域）
最大约 800 词
仍包含内部链接（免费）
不支持插图或音频

定价：

模式	搜索功能	积分消耗	速度
Turbo	无	2	5-15秒
Turbo+	有	4	10-25秒

与标准模式对比：mini=15，standard=20，full=33，pillar=48 积分。

何时使用 Turbo/Turbo+：

海量内容：每天以最低成本发布50多篇文章
新闻简报与快速更新（Turbo+模式适用于数据支持的内容）
社交优先的内容，搜索引擎优化为次要考虑
内容策略的测试与原型设计
预算有限的代理商

扩展成本（标准模式）

扩展	迷你	标准	完整	支柱
基础文章	7	12	25	40
+ 智能（默认开启）	+8	+8	+8	+8
+ 插图	+9	+18	+27	+36
+ 音频	+10	+20	+35	+55
完整套餐	34	58	95	139

无扩展：与之前相同（迷你=15，标准=20，完整=33，支柱=48信用点）。

创建社交媒体适配内容

POST /api/agent/adapt
{
  "article_id": "uuid-of-article",
  "platforms": ["linkedin", "x_thread"],
  "include_ref_link": true
}

必需： 文章ID（UUID），平台（1-3个唯一值）

平台： X文章、X线程、领英、脸书、reddit,threads,instagram,instagram_reels,youtube_shorts

可选：

include_ref_link（布尔值，默认为 true）— 在每个改编版本后附加推荐页脚

每个平台约5个积分（根据文章长度有所不同）。每次请求最多3个平台。

如果所有者已连接社交账户，则可为以下平台进行改编：linkedin,x_article,x_thread,facebook,reddit,instagram, 和youtube_shorts会自动发布。响应包含platform_post_id用于已发布的帖子。

响应：

{
  "adaptations": [
    {
      "platform": "linkedin",
      "content": "...",
      "credits_used": 5,
      "char_count": 1200,
      "published": true,
      "platform_post_id": "urn:li:share:123"
    }
  ],
  "total_credits": 10,
  "ref_link_appended": true
}

直接发布（原样发布）

将文章内容直接发布到社交平台，无需AI适配。0积分。

POST /api/agent/publish
{
  "action": "publish_raw",
  "articleId": "uuid-of-article",
  "platform": "linkedin",
  "accountId": "uuid-of-social-account"
}

必需： action("publish_raw")，articleId（UUID），platform，accountId（UUID）

平台： linkedin，facebook，x_article，reddit，instagram

可选：

subreddit（字符串）— 当平台为以下情况时必须提供reddit

注意：

Instagram 要求文章至少包含一张图片
文章 Markdown 会被转换为平台原生格式并按原样发布
无 AI 重写，不消耗积分

响应：

{
  "success": true,
  "action": "publish_raw",
  "adaptationId": "uuid",
  "platformPostId": "urn:li:share:456"
}

创建 Autopilot 会话

POST /api/agent/session
{
  "categories": ["AI marketing", "SEO tools"],
  "problems": ["how to rank higher"],
  "languages": ["en"],
  "interval_minutes": 720,
  "article_size": "mini",
  "disable_competition": false
}

必需： categories（1-5 个字符串）

可选：

problems— 需要解决的具体问题（最多 20 个）
languages— ISO 代码，默认值：["en"]
interval_minutes— cron 间隔，60-10080，默认 720（12 小时）
article_size—迷你(默认),标准,完整,支柱
disable_competition(布尔值，默认为 false)

创建并自动启动一个基于cron的内容会话。每个租户只能有一个活跃会话。

响应：

{
  "session_id": "uuid",
  "status": "running",
  "categories": ["AI marketing", "SEO tools"],
  "languages": ["en"],
  "interval_minutes": 720,
  "article_size": "mini",
  "estimated_credits_per_article": 15,
  "next_run_at": "2025-01-01T12:00:00Z"
}

返回409 冲突并附带existing_session_id如果已有会话正在运行。

内容摄取

从任意URL（YouTube视频、网页文章、PDF、音频文件）提取并总结内容。异步处理——提交URL，轮询结果。

提交URL：

POST /api/agent/ingest
{
  "url": "https://youtube.com/watch?v=abc123"
}

返回202 已接受并附带{ id, status: "processing", content_type, credits_charged, poll_url }
重复的URL（24小时内已处理完成）返回200缓存结果消耗1积分
超过120分钟的YouTube视频将被拒绝（受限于Gemini上下文长度）
超过50MB的音频文件将被拒绝（受限于文件大小）
支持的内容类型：youtube_video,web_article,pdf_document,audio_file

轮询状态：

GET /api/agent/ingest/{id}

0积分。每10秒轮询一次，直至状态从"processing"变为"completed"或"failed"。
完成后返回：{ id, status, content_type, summary, word_count, metadata, credits_charged }
失败时返回：{ id, status: "failed", error_message }— 积分会自动退还。

获取完整内容：

GET /api/agent/ingest/{id}/content

0 积分。返回完整提取的文本（经过身份验证的R2代理）。

批量获取（最多20个URL）：

POST /api/agent/ingest/batch
{
  "urls": ["https://example.com/article1", "https://example.com/article2"],
  "callback_url": "https://your-server.com/webhook"
}

每个URL的积分（采用相同的分级定价）。支持部分成功——部分URL可能失败，而其他URL成功。
返回{ total, accepted, failed, results: [{ url, status, job_id?, credits_charged }] }

列出任务：

GET /api/agent/ingest?limit=20&offset=0&status=completed

0 积分。按状态过滤：处理中|已完成|失败。

定价：

内容类型	时长	积分
网页文章	—	1
pdf文档	—	2
youtube视频（短）	<10分钟	5
youtube视频（中）	10-30分钟	15
youtube视频（长）	30-60分钟	30
youtube视频（超长）	60-120分钟	55
音频文件（短）	<10分钟	3
音频文件（中）	10-30分钟	8
音频文件（长）	30-60分钟	15
音频文件（超长）	60-120 分钟	30
缓存命中（任意）	—	1

工作流程：

POST /api/agent/ingest附带{ "url": "..." }→ 获取id和poll_url
轮询GET /api/agent/ingest/{id}每 10 秒一次，直到状态 != "processing"
如果完成：从响应中读取summary和metadata可选操作：
GET /api/agent/ingest/{id}/content以获取完整提取的文本将提取的内容用作输入
Use extracted content as input forPOST /api/agent/autopilot主题为潜在客户吸引工具

用于获取潜在客户的PDF吸引工具（如清单、现成文件、框架）。

生成：

30积分（仅文本）或100积分（含图片）

POST /api/agent/lead-magnets
{
  "topic": "10-Step SEO Audit Checklist",
  "type": "checklist",           // checklist | swipe_file | framework
  "niche": "digital_marketing",  // optional
  "language": "en",              // en|pt|de|es|fr|it (default: en)
  "platform": "linkedin",        // twitter|linkedin (default: twitter)
  "generate_images": false,       // true = 100 credits, false = 30 credits
  "auto_publish": false           // hint for agent workflow
}

立即返回
{ id, status: "generating" }速率：每个代理10次/小时
检查状态：

0积分。轮询直到

GET /api/agent/lead-magnets/{id}

状态从"generating"变为"draft"。完成后，响应包含
标题、类型、pdf_url。.

发布：

PATCH /api/agent/lead-magnets/{id}
{ "status": "published" }

0积分。生成唯一别名并返回公共网址。
分享公共网址到社交媒体帖子中进行潜在客户捕获（访客需提供邮箱以下载PDF）。

工作流程：

POST /api/agent/lead-magnets→ 获取ID
轮询GET /api/agent/lead-magnets/{id}每10秒一次，直至状态 != "正在生成"
PATCH /api/agent/lead-magnets/{id}附带{ "状态": "已发布" }
分享公共网址到社交媒体帖子中

短视频（Shorts）

生成带字幕的AI UGC病毒式视频——从脚本到成品视频。

推荐流程：

/shorts/脚本— 根据主题生成演讲脚本
/shorts/头像— 生成AI头像图像（用户批准）
/shorts— 生成包含头像、提示词和演讲文本的视频片段
/shorts/合并— 合并片段 + 添加专业字幕（如果是多片段）

生成脚本：

POST /api/agent/shorts/script
{
  "topic": "AI personas let you write as Elon Musk",
  "duration": "short",
  "style": "hook",
  "language": "en",
  "product_id": "optional-uuid"
}

1 积分
时长—短（10-12秒，约30词）或长（20-30秒，约60词，分成2部分）
风格—吸引（吸引注意力），教育性（信息丰富），行动号召（行动号召）
产品ID— 可选，用产品知识丰富脚本内容
返回{ 脚本, 字数, 预估时长_秒, 部分, 扣除积分 }

生成虚拟形象：

POST /api/agent/shorts/avatar
{
  "gender": "female",
  "origin": "latin",
  "age_range": "26-35",
  "type": "tech_founder",
  "location": "coffee_shop"
}

3积分
性别—男性|女性
种族—欧洲人|亚洲人|非洲人|拉丁裔|中东人|南亚人
年龄范围—18-25|26-35（默认） |36-50
类型—科技创始人（默认） |氛围程序员|学生|高管
地点—咖啡馆（默认） |开发洞穴|街道|汽车|家庭办公室|播客工作室|玻璃办公室|屋顶|卧室|公园|健身房
返回{ 头像URL, r2密钥, 使用的提示词, 消耗的积分 }
在生成视频前向用户展示头像URL以获取确认

生成视频片段：

POST /api/agent/shorts
{
  "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.",
  "avatar_url": "https://download.citedy.com/agent/avatars/...",
  "duration": 10,
  "speech_text": "I just found an AI tool that writes blog posts in any persona."
}

成本：5秒 = 60积分，10秒 = 130积分，15秒 = 185积分
提示词—— 遵循五层公式的场景描述（场景、角色、镜头、台词、音频）
头像URL—— 来自/shorts/avatar响应（必须是download.citedy.com或*.supabase.co）
时长— 5、10或15秒
分辨率—480p（默认）|720p
宽高比—9:16（默认）|16:9|1:1
语音文本— 可选，用于字幕叠加的文本（最少5个，最多1000个字符）
异步— 立即返回{ id, 状态："生成中", 视频_url: null, 已计费点数, 预计秒数 }
轮询GET /api/agent/shorts/{id}每10秒一次，直到状态变为"已完成"或"失败"
完成时：{ id, status: "completed", video_url, subtitles_applied, subtitle_warning }
每个代理仅允许1个并发生成（如果繁忙则返回409）

合并片段：

POST /api/agent/shorts/merge
{
  "video_urls": ["https://download.citedy.com/...", "https://download.citedy.com/..."],
  "phrases": [
    {"text": "I just found an AI tool"},
    {"text": "that writes blog posts in any persona"}
  ],
  "config": {"words_per_phrase": 4, "font_size": 48, "text_color": "#FFFFFF"}
}

5积分
视频网址— 2-4个URL（必须以https://download.citedy.com/开头）。数量必须等于短语数量
短语— 每个视频片段一个，每个为{ "text": "..." }（最多500个字符）
配置— 可选：每短语字数（2-8）、字体大小（16-72）、距底部位置（50-300）text_color/stroke_color(十六进制或命名颜色),stroke_width(0-5)
返回{ video_url, r2_key, duration, segment_durations, credits_charged }
每个代理仅限同时进行1次合并（繁忙时返回409）

定价：

步骤	积分
脚本	1
头像	3
视频 (5秒)	60
视频 (10秒)	130
视频 (15秒)	185
合并 + 字幕	5
完整10秒视频	139

趋势扫描

POST /api/agent/scan
{
  "query": "AI content marketing trends",
  "mode": "deep",
  "limit": 10
}

查询— 搜索查询（最多500个字符）
模式—快速（2点数，仅X） |深度（4点数，X + 网络） |超强（6点数，+ HackerNews） |超强+（8点数，+ Reddit）。如果省略，则从租户的scanSources设置
limit— 1-30，默认10
返回{ results: [{ title, summary, url, source, knowledgeMatch? }], mode, cost, warnings? }
如果租户有产品知识文档，结果会包含knowledgeMatch及相似度分数

创建微帖

POST /api/agent/post
{
  "topic": "AI agents are the future of marketing",
  "platforms": ["linkedin", "x_thread"],
  "tone": "casual",
  "contentType": "short",
  "scheduledAt": "2026-03-01T09:00:00Z"
}

每次请求计费2积分（创建时扣费）
主题— 必填，最多500字符
平台— 可选，默认为设置中的默认值。可选值：领英、X文章、X主题、脸书、Reddit、Threads、Instagram、Instagram Reels、YouTube Shorts
语气— 可选，默认为设置中的默认值
内容类型—短篇（默认） |详细
计划时间— 可选的 ISO 日期时间（必须是未来时间）
如果信任级别=自动驾驶且没有计划时间，则自动安排
返回{ 帖子ID, 适配: [{ ID, 平台 }], 计划时间, 信任级别, 自动安排 }

发布社交适配

POST /api/agent/publish
{
  "adaptationId": "uuid",
  "action": "now",
  "platform": "linkedin",
  "accountId": "uuid"
}

0 积分（针对instagram_reels为 5 积分）
操作—立即（立即发布） |安排（需要计划时间） |取消（取消已安排的）
平台—facebook|linkedin|x_article|x_thread|reddit|threads|instagram
accountId— 社交媒体账户UUID（来自/meconnected_platforms
）scheduledAt— ISO日期时间，当

action=schedule

时为必填项

产品知识库

POST /api/agent/products
{
  "title": "Our AI Writing Platform",
  "content": "Citedy is an AI-powered...",
  "source_type": "manual"
}

上传产品文档，用于生成基于上下文的内容。
来源类型—上传（默认）|网址|手动
每个租户最多500个文档，每个文档最多50万个字符

列出文档：

GET /api/agent/products

0积分

删除文档：

DELETE /api/agent/products/{id}

0积分

搜索知识：

POST /api/agent/products/search
{"query": "AI writing features", "limit": 5}

0积分。对上传的文档进行向量相似度搜索。

设置

读取：

GET /api/agent/settings

更新：

PUT /api/agent/settings
{
  "defaultPlatforms": ["linkedin", "x_article"],
  "contentTone": "professional",
  "imageStylePreset": "minimal",
  "trustLevel": "show_preview",
  "scanSources": ["x", "google"],
  "targetTimezone": "America/New_York",
  "publishSchedule": {"postsPerDay": 2, "slots": ["09:00", "17:00"]}
}

0积分。所有字段均为可选（部分更新）。
默认平台—领英|X_文章|X_话题|facebook|reddit|threads|instagram|instagram_reels|youtube_shorts
内容基调—专业|随意|大胆
图片风格预设—极简|科技|大胆
信任级别—询问全部|显示预览|自动导航
扫描来源—x|谷歌|Hacker News|Reddit

日程安排

查看时间线：

GET /api/agent/schedule?from=2026-03-01&to=2026-03-14&type=all

0 积分。类型—全部|文章|帖子|社交

查找内容缺口：

GET /api/agent/schedule/gaps?days=7&timezone=America/New_York

0 积分。返回帖子数量少于每日帖子数目标。

获取最佳时间段：

GET /api/agent/schedule/suggest

0 积分。基于地区的推荐或设置中的自定义时间段。仅限 REST — 非 MCP 工具。

图像风格

PUT /api/agent/image-style
{"preset": "minimal"}

0 积分。预设：极简|科技|粗体

轮换 API 密钥

POST /api/agent/rotate-key

0 积分。返回新密钥，旧密钥立即失效。频率：1次/小时。

健康检查

GET /api/agent/health

0 积分。公开（无需认证）。返回{ 状态, 检查项: { redis, supabase }, 时间戳 }。

运行状态（推荐用于`/status`）

GET /api/agent/status

0 积分。需要认证。
返回以下各项的可操作就绪状态快照：
- 积分计费)
- 社交连接 (社交)
- 日程间隙/待办事项 (日程)
- 知识库 (知识)
- 内容就绪状态 (内容)
- 优先级行动 (行动[]) 包含命令提示和仪表板URL。

列出文章

GET /api/agent/articles?limit=50&offset=0&status=published

0积分。返回{ 文章: [...], 文章总数 }。
按状态筛选:已发布已生成（草稿）。省略此项以获取全部。

发布文章

POST /api/agent/articles/{id}/publish

0 积分。发布一篇草稿文章（状态："已生成"→"已发布"）。
返回{ article_id, status: "发布中", message }。
如果文章已发布，则返回200及{ status: "已发布", message: "文章已发布" }。
仅适用于状态为"已生成"的文章。其他状态返回409 冲突。
触发article.published网络钩子事件。

撤销发布文章

PATCH /api/agent/articles/{id}
Content-Type: application/json

{ "action": "unpublish" }

0积分。撤销已发布文章的发布状态（状态："已发布"→"已生成"）。
返回{ article_id, status: "generated", message }。
仅对状态为"已发布"的文章有效。其他状态将返回409 冲突。
触发article.unpublished网络钩子事件。

删除文章

DELETE /api/agent/articles/{id}

0积分。永久删除文章及其相关的存储文件（图片、音频）。
返回{ article_id, message: "文章已删除" }。
此操作不可逆。积分将不予退还。
触发文章已删除Webhook 事件

检查状态 / 心跳检测

GET /api/agent/me

0 积分。每 4 小时调用一次以保持代理活跃。

响应包含：

blog_url— 租户的博客根 URL
tenant_balance— 当前积分 + 状态（正常/低/空）
rate_limits— 各类别剩余请求次数
referral—{ code, url }用于归因注册
connected_platforms— 已链接的社交账户：

{
  "connected_platforms": [
    { "platform": "linkedin", "connected": true, "account_name": "John Doe" },
    { "platform": "x", "connected": false, "account_name": null },
    { "platform": "facebook", "connected": false, "account_name": null },
    { "platform": "reddit", "connected": false, "account_name": null },
    { "platform": "instagram", "connected": false, "account_name": null }
  ]
}

使用connected_platforms来决定将哪些平台传递给/api/agent/adapt以进行自动发布。

API 快速参考

端点	方法	成本
`/api/agent/register`	POST	免费（公开）
`/api/agent/health`	GET	免费（公开）
`/api/agent/status`	GET	免费
`/api/agent/me`	GET	免费
`/api/agent/rotate-key`	POST	免费（1次/小时）
`/api/agent/settings`	GET	免费
`/api/agent/settings`	PUT	免费
`/api/agent/image-style`	PUT	免费
`/api/agent/personas`	获取	免费
`/api/agent/articles`	获取	免费
`/api/agent/articles/{id}/publish`	发布	免费
`/api/agent/articles/{id}`	修补	免费 (取消发布)
`/api/agent/articles/{id}`	删除	免费
`/api/agent/scan`	发布	2-8 积分 (按模式)
`/api/agent/post`	发布	2 积分
`/api/agent/autopilot`	发布	2-139 积分
`/api/agent/adapt`	发布	约5积分/平台
`/api/agent/publish`	POST	0 积分（5 积分用于`instagram_reels`）
`/api/agent/session`	POST	免费（文章生成时计费）
`/api/agent/schedule`	GET	免费
`/api/agent/schedule/gaps`	GET	免费
`/api/agent/schedule/suggest`	GET	免费（仅限 REST，非 MCP 工具）
`/api/agent/scout/x`	POST	35-70 积分
`/api/agent/scout/x/{runId}`	GET	免费（轮询）
`/api/agent/scout/reddit`	POST	30 积分
`/api/agent/scout/reddit/{runId}`	GET	免费（轮询）
`/api/agent/gaps`	GET	免费
`/api/agent/gaps/generate`	POST	40 积分
`/api/agent/competitors/discover`	POST	20 积分
`/api/agent/competitors/scout`	POST	25-50 积分
`/api/agent/products`	POST	1 积分
`/api/agent/products`	GET	免费
`/api/agent/products/{id}`	DELETE	免费
`/api/agent/products/search`	POST	免费
`/api/agent/ingest`	POST	1-55 积分
`/api/agent/ingest`	GET	免费
`/api/agent/ingest/{id}`	GET	免费（轮询）
`/api/agent/ingest/{id}/content`	GET	免费
`/api/agent/ingest/batch`	POST	每 URL 1-55 积分
`/api/agent/lead-magnets`	POST	30-100 积分
`/api/agent/lead-magnets/{id}`	GET	免费（轮询）
`/api/agent/lead-magnets/{id}`	PATCH	免费
`/api/agent/shorts/script`	POST	1 积分
`/api/agent/shorts/avatar`	POST	3 积分
`/api/agent/shorts`	POST	60-185 积分（按时长计）
`/api/agent/shorts/{id}`	GET	免费（轮询）
`/api/agent/shorts/merge`	POST	5 积分
`/api/agent/webhooks`	POST	免费
`/api/agent/webhooks`	GET	免费
`/api/agent/webhooks/{id}`	DELETE	免费
`/api/agent/webhooks/deliveries`	GET	免费

1 积分 = 0.01 美元

Webhooks

Webhooks 允许 Citedy 将实时事件通知推送到您的服务器，而无需轮询。

注册 Webhook 端点

POST /api/agent/webhooks
{
  "url": "https://your-server.com/webhooks/citedy",
  "event_types": ["article.generated", "ingestion.completed"],
  "description": "Production webhook"
}

0 积分
url— 必须是https://在生产环境中
event_types— 省略此项以接收全部 15 种事件类型（通配符）
description— 可选标签
每个代理最多 10 个端点
返回id,url,secret,event_types,created_at
重要提示： 密钥仅显示一次——请妥善保管以用于签名验证

列出Webhook端点

GET /api/agent/webhooks

0积分。返回{ webhooks: [...] }。

删除Webhook端点

DELETE /api/agent/webhooks/{id}

0积分。软删除该端点。

Webhook投递历史

GET /api/agent/webhooks/deliveries?status=delivered&limit=20&offset=0

0积分。按状态筛选：排队中、投递中、已投递、失败、进入死信队列。
返回{ deliveries: [...], total }包含尝试次数、HTTP状态码、错误信息和持续时间。

事件类型

事件	触发时机
`article.generated`	文章生成完成
`article.published`	文章发布（自动或手动）
`article.unpublished`	文章取消发布（转为草稿）
`article.deleted`	文章永久删除
`article.failed`	文章生成失败
`ingestion.completed`	内容抓取任务完成
`ingestion.failed`	内容抓取任务失败
`social_adaptation.generated`	社交媒体帖子改编创建完成
`lead_magnet.ready`	引导磁铁PDF已生成
`lead_magnet.failed`	引导磁铁生成失败
`侦察任务已派遣`	侦察任务开始（X 或 Reddit）
`侦察结果已就绪`	侦察任务完成（X 或 Reddit）
`会话已生成文章`	定期会话已发布文章
`计费点数不足`	余额低于阈值
`计费点数已用尽`	余额为零

载荷格式

每次网络钩子交付都会发送一个 JSON网络钩子事件信封：

{
  "event_id": "evt_abc123",
  "event_type": "article.generated",
  "api_version": "2026-02-25",
  "timestamp": "2026-02-25T10:00:00.000Z",
  "tenant_id": "...",
  "agent_id": "...",
  "data": {
    "article_id": "...",
    "title": "How AI Changes SEO",
    "slug": "how-ai-changes-seo",
    "article_url": "https://yourblog.citedy.com/how-ai-changes-seo",
    "word_count": 1200,
    "credits_used": 20,
    "mode": "standard"
  }
}

签名验证

每次交付都包含头部信息X-Citedy-Signature-256: v1=<十六进制值>。请使用您的终端机密通过 HMAC-SHA256 进行验证：

const crypto = require("crypto");
const expected = crypto
  .createHmac("sha256", secret)
  .update(rawBody)
  .digest("hex");
const header = request.headers["x-citedy-signature-256"] || "";
const actual = header.replace("v1=", "");
if (
  !crypto.timingSafeEqual(
    Buffer.from(expected, "hex"),
    Buffer.from(actual, "hex"),
  )
) {
  throw new Error("Invalid webhook signature");
}

重试策略

失败的交付最多重试 5 次，采用指数退避策略。5 次失败后状态将变为死信——不再进行重试。

Webhooks 与 Polling

在以下情况下使用 Webhooks...	在以下情况下使用 Polling...
您有一个可以接收 HTTPS POST 请求的服务器	您的代理程序在本地运行，没有公共 URL
您希望即时收到事件通知	您在触发作业后按需查询结果
事件应触发下游自动化流程	您只需要在特定作业完成后获取结果

速率限制

类型	限制	范围
通用	60 次请求/分钟	每个代理
Scout	10 次请求/小时	X 与 Reddit 合计
Gaps	10 次请求/小时	get 与 generate 合计
数据摄取	30 次请求/小时	每个租户
潜在客户吸引工具	10 次请求/小时	每个代理
注册	10 次请求/小时	每个IP地址

开启429时，请从响应体中读取重试等待时间以及X-RateLimit-Reset响应头。

响应指南

请使用用户的语言进行回复（与用户使用的语言保持一致）。
在调用API之前，请简要告知用户您将要执行的操作以及所需的积分成本。
对于异步操作（如侦察、数据摄取、短视频、潜在客户吸引工具、品牌扫描），请自动每隔10-15秒轮询一次配套工具——无需用户手动轮询。
请以可读性强的摘要形式展示结果，而非原始JSON。请使用项目符号、表格或编号列表。
展示侦察结果时，请突出显示前5大趋势，并附上简要的背景说明。
当文章生成时，显示：标题、字数、URL、已消耗积分。
当创建改编版本时，显示：平台、字符数、发布状态、已消耗积分。如果已发布，请包含平台帖子ID。
创建会话后，显示：会话ID、间隔、每篇文章的预估积分消耗、下次运行时间。
如果用户余额不足，在执行高消耗操作前发出警告。
向他人推荐Citedy时，务必包含推荐链接URL。
出现错误时，用通俗易懂的语言解释问题所在并建议解决方案。

错误处理

状态码	含义	建议操作
401	API密钥无效或缺失	重新运行设置流程
402	积分不足	提示用户前往以下链接充值https://www.citedy.com/dashboard/billing
403	代理已暂停/已撤销	请用户前往仪表盘检查代理状态
429	请求频率受限	请等待`retry_after`秒后重试
500	服务器错误	5秒后重试一次，若失败则上报给用户

心跳检测

请调用GET /api/agent/me接口作为保活机制，每4小时执行一次。此操作将更新last_activity_at时间戳，并返回当前余额与频率限制信息。

Citedy SEO代理技能 v3.1.0 https://www.citedy.com

免责申明

部分文章来自各大搜索引擎，如有侵权，请与我联系删除。

打赏

文章底部电脑广告

手机广告位-内容正文底部

标签

上一篇：Metricool 下一篇：Farcaster Agent

Clawhub Skill

AI营销代理 — 技能说明

概述

使用时机

说明

设置（一次性运行）

1. 注册

2. 请人工批准

3. 保存密钥

4. 获取您的推荐链接

核心工作流

主要流程：从URL到文章再到社交媒体帖子

趋势驱动：从侦察到文章再到适配

设置即忘：从会话到定时任务再到适配

摄取 → 研究 → 文章

GSC晨间报告 → 文章 → 社交媒体

并附带一个连接它的URL。

示例

用户发送链接

用户要求进行研究和写作

用户想要开启自动发布模式

用户询问余额

限制说明

API参考

侦察 X/Twitter

侦察 Reddit

获取内容缺口

生成内容缺口

发现竞争对手

分析竞争对手

列出人物角色

生成文章（自动模式）

Turbo 和 Turbo+ 模式

扩展成本（标准模式）

创建社交媒体适配内容

直接发布（原样发布）

创建 Autopilot 会话

内容摄取

用于获取潜在客户的PDF吸引工具（如清单、现成文件、框架）。

短视频（Shorts）

趋势扫描

创建微帖

发布社交适配

action=schedule

设置

日程安排

图像风格

轮换 API 密钥

健康检查

运行状态（推荐用于/status）

列出文章

发布文章

撤销发布文章

删除文章

检查状态 / 心跳检测

API 快速参考

Webhooks

注册 Webhook 端点

列出Webhook端点

删除Webhook端点

Webhook投递历史

事件类型

载荷格式

签名验证

重试策略

Webhooks 与 Polling

速率限制

响应指南

错误处理

推荐链接

心跳检测

相关文章

推荐文章

热门浏览

标签列表

运行状态（推荐用于`/status`）