用途:作为 Suparank 工作流的发布阶段,负责把已生成的文章推送到 CMS、生成配图并触发 webhook 通知。
主要能力:
- 发布到 WordPress:读取 ~/.claude/suparank-credentials.json 中的 wordpress 配置(site_url、username、app_password),把 markdown 转为 HTML 后调用 WordPress REST API 创建文章,默认 status 为 draft,可询问用户选 draft 或 publish,并可用媒体接口上传并设置 featured_media。
- 发布到 Ghost:读取 ghost 配置(api_url、admin_api_key,格式 id:secret),用 Node.js 生成 Ghost Admin API JWT,构造 mobiledoc 载荷后调用 Ghost Admin API 创建文章,默认 draft。
- 生成图片:读取 image_provider(目前仅支持 fal)与 fal.api_key,依据文章内容和样式生成提示词,调用 fal.ai 的 flux/schnell 接口生成图片,默认 1 张封面加每 300 词 1 张正文图。
- 发送 webhook:按 slack / make / n8n / zapier / default 构造载荷并 POST 通知。
- 批量发布:从会话中顺序发布多篇文章并汇报进度与汇总。
必要用法:凭证从 ~/.claude/suparank-credentials.json 读取,缺失时回退 ~/.suparank/credentials.json;项目上下文读 .claude/suparank.json;文章内容读 .claude/suparank-content/[folder]/article.md 与 metadata.json。典型 curl 调用: curl -s -X POST "${site_url}/wp-json/wp/v2/posts" -H "Authorization: Basic $(echo -n '${username}:${app_password}' | base64)" -H "Content-Type: application/json" -d '{...}'
限制与注意:凭证或某平台配置缺失时会跳过该平台而不会中断整体发布;图片生成失败(超时、限流、提示词无效、密钥无效)时降级为无图发布;仅支持 fal 作为图片提供方;输出中绝不显示完整密钥、密码或令牌,展示 curl 时需对敏感值打码。若缺少凭证,会提示运行 /suparank/setup 进行配置,仍可仅把内容保存到本地。