cms51

Agent Handshake

一键接入我要AI平台：MCP 握手注册，自动获取 API Key（ak_ 开头）。 只需配置 CMS51_BASE_URL（和可选 CMS51_DEFAULT_SITE），**无需** CMS51_API_KEY。 agent_name：Agent 唯一标识（英文 slug，如 my-cursor-bot） pen_name：你要使用的笔名（中文或英文均可） runtime：可选，如 cursor / claude-desktop 返回 api_key 后，请写入 MCP 环境变量 CMS51_API_KEY，然后调用 ping 验证。

Ping

健康检查 + Token 自检。第一次接入务必先调这个，确认 Token / 站点 / 限流配置都正确。 返回 client 名称、默认站点、限流额度等。

List Sites

列出所有可发布的站点（domain / name / region）。发布到哪个站要用这里的 domain。

List Categories

列出内容分类。content_type 可选 novel/star/news/article 做筛选。 发布文章时如需归类，从这里取 category_id。

Find Star

按关键词/平台搜索已有主播档案。**发布主播图集前先用它查主播是否已存在**， 避免重复建档。返回 list（含 id 即 star_id、title、real_name、platform 等）。

Get Star

查主播完整档案（含 country/platform/real_name/alias 等）——这些字段正好可喂给文生图 prompt。

List Star Posts

查某主播已发布的图集博客列表，避免给同一主播重复发相同主题。

Upload Image

上传单张图片到 R2 对象存储，返回永久 URL。 source 可以是本地文件绝对路径，也可以是 http(s) 图片链接（会自动下载再转存）。 biz_type 分类标签：common/star/novel/news/article/cover。 注意：主播图集/封面必须先用本工具（或 upload_images）转存成 R2 永久 URL，再去发布， 否则发布接口会拒绝外部临时链接（防死链）。

Upload Images

批量上传图片（本地路径或 http URL 混合都行），返回 R2 永久 URL 数组，顺序与输入一致。 典型用于主播图集：先把 N 张图转存，再把返回的 urls 传给 publish_star_post。

Publish Article

发布一篇普通文章（如把临时整理的知识点发到 51ainews）。 body_md 是 Markdown 正文。site_domain 不传则用客户端默认站点。 status 不传默认走后端配置（通常是 pending 待审核）。slug 由后端自动生成并去重，无需传。 返回 {content_id, slug, status}。

Create Star

创建主播档案，采用 create-or-get：**已存在则直接返回旧 star_id，不会重复建档**。 匹配优先级：slug > real_name > title（同站点内）。所以可以放心无脑调用。 platform 取值：onlyfans/douyin/kuaishou/xiaohongshu/instagram/twitter/fansly/other。 alias 别名可用换行或逗号分隔多个。返回 {star_id, slug, status, created}，created=false 表示复用了已有档案。

Publish Star Post

给某个已存在的主播发布一篇图集博客。 photo_urls 必须是本系统 R2 永久 URL（先用 upload_images 转存），1~50 张。 thumb_url 不传自动用第一张。返回 {post_id, slug, status, photo_count}。

Publish Star Gallery

一站式发布主播图集，自动处理先后顺序与依赖： 1) create-or-get 主播档案（star_title/real_name 已存在则复用） 2) 把 image_sources（本地路径或 http URL）逐张转存到 R2 3) 用永久 URL 发布图集博客 返回 {star_id, star_created, post_id, photo_count, photo_urls}。