ShapelessAI

ShapelessAI

ShapelessAI 管理你的社交媒体形象：它会在你已连接的平台上起草、安排并发布内容，保存你的品牌记忆，并让常驻 Agent 在你休息时持续工作。

此仓库是 Agent 接口 的公开入口：shapeless CLI、MCP 服务、Claude Code 插件和问题跟踪器。你的 Agent 或脚本可以操控 ShapelessAI 账户：撰写和安排帖子、创建任务并恢复卡住的任务、审批和发布、编辑品牌记忆，以及管理常驻 Agent。

文档位于 shapelessai.com/docs——包含路由、权限范围、平台限制、拒绝代码，并按主题分别介绍。每个页面也提供原始 Markdown：在路径后添加 .md（https://shapelessai.com/docs/posts.md），或发送 Accept: text/markdown。如果 Agent 想一次获取全部文档，请读取 shapelessai.com/llms-full.txt。

安装

npx shapelessai --help      # one-off
npm i -g shapelessai        # keeps `shapeless` on your PATH

Node 20 或更高版本。

身份验证

在工作室中创建密钥：设置 -> API 密钥（/studio/api-keys）。只授予调用方所需的权限范围——read、write 或 publish。只有 publish 才能发布内容。

shapeless login             # paste the key; we verify it and store it 0600
export SHAPELESS_API_KEY=slk_...   # or: env var, beats the stored key

配置存放在 ~/.config/shapeless/config.json。SHAPELESS_BASE_URL 可覆盖 API 主机（默认为 https://shapelessai.com）。shapeless logout 会删除本地副本；如需撤销密钥，请在工作室中操作。

每条命令都支持 --json，用于打印原始 API 响应；也支持 --help。

帖子

自行撰写内容并加入发布队列——立即发布、定时发布，或排入账户下一个空闲时段。需要 publish 权限范围。

shapeless connections                     # the accounts and their ids
shapeless platforms                       # limits, media rules, settings schema (no key needed)

shapeless posts create --to <connectionId> --text "Shipping day."                       # now
shapeless posts create --to <connectionId> --text "..." --at 2026-09-21T09:00:00+03:00  # at a time
shapeless posts create --to <connectionId> --text "..." --queue                         # next free slot
shapeless posts create --to <connectionId> --text "..." --media k1,k2 \
  --first-comment "Link: https://..."      # LinkedIn, X, Bluesky
shapeless posts create --to <youtubeConnectionId> --text "..." --media <clip.mp4 key> \
  --title "The video title" --settings '{"privacyStatus":"unlisted"}'

MCP 工具为 posts_create，参数相同：connectionId、text、mediaKeys、title、scheduledAt 或 queue: true、settings、firstComment。请先读取 platforms_list，了解平台限制及其 settingsSchema。

免费套餐：每天最多发布十条帖子，按每条帖子的发布时间所在的 UTC 日期计数，因此提前安排的一周内容是每天十条，而不是总共十条。第十一条会返回 402 {code: "free_daily_cap", limit, day, resetsAt}，其中会指出已满的日期。撰写、安排和发布都不会消耗额度；免费套餐每月还为 Agent 团队提供价值 $5 的额度。付费套餐没有上限。详情请见：shapelessai.com/docs/posts。

任务：持久化运行

任务是由服务端持续运行的任务，无论你是否保持连接——非常适合 Agent 和 cron。

# Fire and forget
shapeless jobs create draft three posts about our beta launch

# Watch it live (tails the event stream, falls back to polling)
shapeless jobs create plan this week --label "Weekly plan" --budget 2.50 --watch

# Come back later
shapeless jobs list               # 200 newest; prints a cursor if older jobs exist
shapeless jobs list --before <cursor>   # the next page back
shapeless jobs show <id>          # transcript summary + outputs
shapeless jobs tail <id>          # re-attach to the live stream

# Put files on the message - the agent sees the image, not just its name
shapeless jobs create does this thumbnail work? --attach ./thumb.png --attach ./notes.md
shapeless jobs continue <id> and this one --media-key workspace-assets/<account>/logo.png

# Resume a stuck or failed run - history is rebuilt server-side
shapeless jobs continue <id> keep going, but make the second post shorter --watch

shapeless jobs stop <id>

帖子：队列

shapeless posts list --status proposed
shapeless posts show <id>
shapeless posts approve <id> <id> <id>    # proposed -> scheduled  [publish]
shapeless posts dismiss <id>
shapeless posts publish <id>              # out, now  [publish]
shapeless posts mark-posted <id> --url https://...

Agent、品牌记忆、资源

shapeless agents list
shapeless agents create --name "Daily reach" --prompt "..." --days mon,thu --hours 9
shapeless agents edit <id> --status paused        # or: shapeless agents pause <id>
shapeless agents wake <id>                        # run it now  [publish]

shapeless brain ls
shapeless brain get positioning.md
shapeless brain put voice.md --file ./voice.md    # or pipe on stdin
shapeless brain import ./pitch-deck.pdf
shapeless brain export --out brain.zip

shapeless assets list
shapeless assets upload ./logo.png
shapeless connections

MCP 服务

托管服务地址为 https://shapelessai.com/mcp。将该 URL 添加到任何支持远程 MCP 的主机 - Claude（Settings -> Connectors -> Add custom connector）、ChatGPT（Developer mode）、Claude Code、Cursor、Codex、VS Code、Gemini CLI - 然后打开 ShapelessAI 标签页进行登录和授权。使用 OAuth，无需密钥。各主机的操作步骤采用供应商提供的原文，见 shapelessai.com/connect。

无法打开浏览器的客户端（Agent SDK、CI 任务、可自托管的 Agent）可跳过 OAuth：将 Settings -> API keys 中的 API 密钥作为 Authorization: Bearer slk_... 发送到同一 URL。任何支持设置标头的 MCP 客户端都可以使用；密钥的权限范围即为该密钥的权限范围。

curl -s https://shapelessai.com/mcp -H "Authorization: Bearer $SHAPELESS_API_KEY" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

claude mcp add --transport http --scope user shapeless https://shapelessai.com/mcp   # then /mcp -> Authenticate
codex mcp add shapeless --url https://shapelessai.com/mcp && codex mcp login shapeless
gemini mcp add --transport http shapeless https://shapelessai.com/mcp

同一批工具（posts_create、jobs_create、posts_approve、brain_write，等等）也可在本地运行：shapeless mcp 通过 stdio 提供 MCP 服务，使用 shapeless login 保存的 API 密钥，并添加可读取磁盘的工具（assets_upload、brain_import，以及作业消息中的 files）。每个工具都带有标题和注解 - 只读工具可自由运行；任何会发布内容、花费资金或覆盖内容的工具都会标记为破坏性操作，因此主机会先征求你的同意 - 每个工具的描述也会注明所需的权限范围。

除了账户工具外，我们自有工作室 Agent 使用的每个工具也都各自作为 MCP 工具提供，共 32 个：generate_image、generate_footage、edit_footage、render_carousel、speak、caption_file、web_search、x_pulse 等。每个工具都会将生成的文件作为媒体密钥返回，你可以用 posts_create 发布这些文件。各工具费用表见 shapelessai.com/docs/mcp；tools_list 可实时读取该表。

作业就是一段对话，因此你可以在终端和 Web 应用之间双向传递工作内容：

• 每个作业结果都包含一个 url - https://shapelessai.com/studio/c/<id> - 让 Agent 可以将刚完成的工作链接交给用户。
• jobs_brief <id> 是回复前的低成本读取方式：包含最近 30 条消息（经过截断）、已移除推理和工具活动、资源清单，以及按队列状态统计的帖子数量。结果是确定性的，过程中不涉及模型。jobs_get 仍会返回完整记录。
• jobs_list 每次最多返回 200 个作业，按最新优先排序，并附带 nextCursor；将其作为 before 传回即可继续查看更早的记录。
• jobs_tail <id> 会监视作业运行（最多 60 秒、200 个事件），并返回事件以及用于恢复查看的游标；如果作业没有可连接的运行事件流，则会返回 {live: false}，而不会报错。
• jobs_create 和 jobs_continue 支持接收文件：files（绝对本地路径 - .md/.txt 文件会以内联方式传递；图片、视频、音频和 PDF 会在此处上传）和 mediaKeys（账户中已有的任何内容，例如 assets_upload 返回的内容）。每条消息最多 6 个文件。文件会附加到用户在工作室中看到的消息上，Agent 也会实际读取它们 - 对于图片，会在该轮对话中内联其像素数据，而不只是文件名。

这里有一个提示词 continue（参数：id），Claude Code 会将其显示为斜杠命令：它会加载该对话的摘要，并指示 Agent 使用 jobs_continue 在同一对话线程中回复。

在本地主机而非托管服务上运行 stdio 服务 - Claude Code：

claude mcp add shapeless -e SHAPELESS_API_KEY=slk_... -- npx shapelessai mcp

Claude Desktop（claude_desktop_config.json）及其他仅支持 stdio 的主机：

{
  "mcpServers": {
    "shapeless": {
      "command": "npx",
      "args": ["shapelessai", "mcp"],
      "env": { "SHAPELESS_API_KEY": "slk_..." }
    }
  }
}

如果未设置环境变量，服务将使用 shapeless login 保存的密钥。

Agent 插件（Cursor、Kiro、Copilot、Codex）和 Gemini CLI

plugins/shapeless 同时也是一个 Agent Plugins 1.0 软件包（plugin.json、mcp.json、skills/），因此任何可加载该格式的客户端都会安装托管 MCP 服务和本仓库中的技能。Gemini CLI 会读取根目录下的 gemini-extension.json：

gemini extensions install https://github.com/FirstClassTree/shapelessai

Claude Code 插件

这个仓库也是一个插件市场。shapeless 插件会接入托管的 MCP 服务， 并附带一个技能，教 Claude 如何使用它——包括作用域、发布队列，以及何时使用 Brand Memory：

/plugin marketplace add FirstClassTree/shapelessai
/plugin install shapeless@shapeless

然后运行 /mcp，选择 shapeless 并选择 Authenticate——浏览器标签页会为你完成一次登录。

ShapelessAI 还收录在哪里

同一 MCP 服务和技能，可从客户端已读取的注册表中安装：

• MCP：官方 MCP 注册表（com.shapelessai/shapeless）、 Smithery、 Glama、 LobeHub
• 插件和技能：cursor.directory、 ClawHub、 skills.sh
• 产品目录：Twelve Tools、 Product Watch、 Lifto

API

以上所有内容都基于一份文档化的契约： shapelessai.com/docs/api——其中包含每个路由、所需的作用域、 速率限制，以及哪些接口会有意拒绝 API 密钥。机器可读版本见 /api/openapi.json。

页面	说明
/docs	从这里开始：密钥、MCP URL、CLI、三种操作
/docs/posts	创建、安排、排队、媒体、首条评论，以及所有拒绝情形
/docs/platforms	各平台的限制和规则，实时数据来自 GET /api/platforms
/docs/api	密钥可访问的所有路由及其所需作用域
/docs/cli	shapeless 命令
/docs/mcp	托管的 MCP 服务及其工具
/docs/jobs	持久化运行
/docs/brand-memory	账户的持久化知识
/docs/auth	密钥、作用域、OAuth、速率限制

支持与隐私

• 支持：[email protected]，或提交问题。 CLI 根据上述契约开发；此仓库用于发布 CLI。
• 隐私政策：shapelessai.com/privacy
• 条款：shapelessai.com/terms