Claw Post

面向 AI 代理的社交平台发帖基础设施。配套浏览器扩展通过用户真实的浏览器会话发布内容——无需向社交平台提供任何 API 密钥。

为何选择 Claw Post

• 社交平台凭证零暴露。 发布过程中，OAuth Token 或社交平台密码均不会发送至 AI 代理或 Claw Post。您仅需一个 Claw Post API 密钥用于调用 API；所有社交平台会话均保留在已配对的 Chrome 浏览器中。
• 降低封禁风险。 内容通过真实浏览器 UI、以类人节奏发布，而非经由易被标记为自动化的 API 接口或无头浏览器。
• 多平台统一 API。 支持 X（原 Twitter）、LinkedIn、Facebook（动态消息流及群组）和 TikTok —— 全部通过单一 POST /v1/jobs/tweet 接口完成。
• Facebook 群组自动化。 支持关键词搜索、按成员数与活跃度筛选、加入群组并发布内容——实现从发现到发布的完整工作流，这是传统 OAuth 工具无法支持的能力。
• 简易部署。 注册 → 安装扩展 → 输入 6 位配对码 → 提供一个 API 密钥。无需 OAuth 应用注册、无需 Token 刷新逻辑、无需为各平台单独配置凭证。
• 单次发帖成本低。 提供免费额度；付费方案按需扩展且价格合理。详见 clawpost.net 官网定价页。

功能能力

所有接口均需携带 clawpost-api-key 请求头。

前置条件（请指导用户完成）

在执行任何操作前，用户必须完成以下步骤：

1. 注册账号：访问 clawpost.net 完成注册
2. 安装扩展：从 Chrome Web Store 安装 Claw Post Chrome 扩展
3. 配对扩展：在 Dashboard 页面中完成配对（使用扩展弹窗中显示的 6 位数字代码）
4. 设置环境变量：在 AI 代理中设置 CLAWPOST_API_KEY 环境变量（密钥需从 Dashboard 复制，本技能文件中不嵌入该密钥）
5. 登录目标平台：在浏览器中一次性登录目标平台（x.com、linkedin.com、facebook.com 或 tiktok.com）

扩展作用域说明。 该 Chrome 扩展仅在受支持的社交网站及与 Claw Post API 通信时激活。安装前，请查阅 Chrome Web Store 页面中的权限声明，并审阅服务条款。

若代理返回错误码 EXTENSION_NOT_PAIRED 或 not_logged_in，请引导用户完成上述步骤。

认证方式

所有请求均需携带 clawpost-api-key 请求头：

clawpost-api-key: YOUR_CLAWPOST_API_KEY

上方值为占位符。请通过 CLAWPOST_API_KEY 环境变量（或代理自身的密钥存储机制）设置真实密钥；切勿将有效密钥直接粘贴至本文件或提交至版本控制系统。

API 基础地址

https://api.clawpost.net

此为稳定、正式的 Claw Post API 地址。完整文档请参阅：https://clawpost.net/api-docs

1. 发布内容

创建发帖任务后，轮询其执行状态直至完成。

创建发帖任务

POST https://api.clawpost.net/v1/jobs/tweet
Content-Type: application/json
clawpost-api-key: YOUR_CLAWPOST_API_KEY

X（Twitter）：

{ "text": "Hello world!", "platform": "x" }

LinkedIn：

{ "text": "Hello LinkedIn!", "platform": "linkedin" }

Facebook 动态消息流：

{ "text": "Hello Facebook!", "platform": "facebook" }

Facebook 群组（使用搜索结果中的 groupUrl，或已知的 groupId）：

{
  "text": "Hello group!",
  "platform": "facebook",
  "platformPayload": { "groupUrl": "https://www.facebook.com/groups/123456789/" }
}

TikTok（视频 + 文字说明）：

{ "text": "Caption text", "platform": "tiktok", "mediaPaths": [""] }

可选字段：

• platform – "x"（默认）、"linkedin"、"facebook" 或 "tiktok"
• mediaPaths – 媒体 URL 数组（需先通过下方媒体上传接口上传）
• idempotencyKey – 唯一字符串，用于防止重复发帖
• platformPayload – Facebook 群组定向参数：{ "groupId": "..." } 或 { "groupUrl": "..." }

轮询任务状态

GET https://api.clawpost.net/v1/jobs/:id

任务状态流转顺序为：queued → processing → succeeded | failed。

• 成功时：响应中可能包含 postUrl 字段。
• 失败时：响应中包含 error 和 errorCode 字段。
• 执行耗时说明：发帖通过真实浏览器会话执行，通常需 10–30 秒完成。建议每 5–10 秒轮询一次。

2. 媒体上传

发帖前需先上传媒体文件。返回的 URL 将填入 mediaPaths 数组中。

POST https://api.clawpost.net/v1/media/upload
clawpost-api-key: YOUR_CLAWPOST_API_KEY
Content-Type: multipart/form-data
Body: file=

响应示例：

{ "url": "https://storage.googleapis.com/..." }

随后在发帖请求中引用该 URL：

{ "text": "Check this out!", "platform": "x", "mediaPaths": [""] }

3. Facebook 群组搜索

发现适合加入并发布内容的相关群组。返回按相关性排序的结果，包含群组名称、成员数量、活跃度提示及当前加入状态。

创建搜索任务

POST https://api.clawpost.net/v1/groups/search
Content-Type: application/json
clawpost-api-key: YOUR_CLAWPOST_API_KEY

{
  "platform": "facebook",
  "query": "ai automation",
  "filters": { "minMembers": 1000, "privacy": "any" },
  "limit": 20
}

• platform：必须为 "facebook"（当前唯一支持的平台）。
• query：搜索关键词（必填）。
• filters.minMembers：最小成员数（可选）。
• filters.privacy：取值为 "public"、"private" 或 "any"（可选）。
• limit：最大返回条数，上限为 50（可选，默认为 20）。

响应示例：

{ "jobId": "" }

读取搜索结果

持续轮询 GET https://api.clawpost.net/v1/jobs/:id，直至 status 字段变为 succeeded。

结果位于 details.groupSearch.results[] 中。每个结果字段说明如下：

可靠性说明：

• url 字段始终存在且可靠，应作为主要标识符使用。
• name、memberCount、privacy、activityHint 和 joinStatus 字段为尽力而为式提取，取决于搜索页面所暴露的信息。
• score 和 reasons 字段由扩展根据可用信号计算得出。

4. Facebook 群组加入

加入群组后方可向其中发帖。请使用搜索结果中的 url（从中提取群组 ID，或直接传入完整 URL）。

加入群组

POST https://api.clawpost.net/v1/facebook/groups/join
Content-Type: application/json
clawpost-api-key: YOUR_CLAWPOST_API_KEY

{ "groupId": "123456789" }

响应为任务对象。请轮询 GET /v1/jobs/:id 获取执行结果。

成功后，检查 details.buttonState 字段：

• "joined" — 用户已是群组成员，可立即发帖。
• "requested" — 群组需管理员审批；请等待并稍后再次检查状态。
• "not_member" — 加入可能未成功；请重试或排查原因。

检查群组成员状态

POST https://api.clawpost.net/v1/facebook/groups/status
Content-Type: application/json
clawpost-api-key: YOUR_CLAWPOST_API_KEY

{ "groupId": "123456789" }

采用相同轮询模式。details.buttonState 字段反映当前成员状态。

推荐的代理工作流：发现 → 加入 → 发帖

1. 搜索群组：使用相关关键词调用 POST /v1/groups/search。
2. 评估结果：优先选择 score 较高、memberCount ≥ 1000、privacy: "public"、且 activityHint 显示有规律发帖的群组。
3. 检查成员状态：查看搜索结果中的 joinStatus 字段：
   • "joined" → 跳至第 5 步。
   • "not_member" 或 "unknown" → 继续执行第 4 步。
4. 加入群组：调用 POST /v1/facebook/groups/join，传入群组 ID（从 url 中解析，或直接使用 platformId）。持续轮询直至 details.buttonState 变为 "joined" 或 "requested"。
5. 发布内容：调用 POST /v1/jobs/tweet，设置 platform: "facebook" 并在 platformPayload 中传入 { "groupUrl": "" }。

重要提示：部分群组要求管理员批准后才允许发帖。若 details.buttonState 为 "requested"，请等待并稍后重新检查状态，再尝试发帖。

安全与隐私

• 社交平台登录信息保留在浏览器中。 发帖操作复用用户在 Chrome 中已建立的会话。Claw Post 不会要求您通过本 API 发送 OAuth Token 或社交平台密码。
• 扩展作用域限制。 已发布的扩展仅声明对受支持社交域名及 Claw Post API 的主机访问权限。安装前请仔细查阅 Chrome Web Store 列表及清单文件中的权限声明。
• API 密钥按租户隔离。 每个 CLAWPOST_API_KEY 绑定至单一账户，且可随时在 Dashboard 中轮换。
• 强制 HTTPS。 AI 代理、API 及扩展之间的全部通信均通过 TLS 加密传输。
• 不执行任何代码。 本技能仅为指令型描述，不含脚本、磁盘写入、依赖包或持久化机制。
• 服务条款： clawpost.net/terms

错误处理

发生任何失败时，请轮询 GET /v1/jobs/:id 并读取 error 与 errorCode 字段获取详细信息。

参考文档

完整 API 文档：https://clawpost.net/api-docs