agentic-account

agentic-account

npm package · CLI · Library · Safety · Limits

agentic-account 是一个本地优先的 TypeScript 库、CLI 和 MCP 服务，可规划并跟踪一个品牌在十个平台上的社交账号创建工作。 它引导整个工作流——清单、状态机、预热计划——并将每个验证关卡交由人工处理，而非绕过验证。

安装

npm install agentic-account

有两个运行时依赖：MCP SDK 和 zod。

跟踪你的第一个账号

agentic-account account create --platform instagram --handle acme --email-ref BRAND_EMAIL
agentic-account account checklist --id <id>
agentic-account account advance --id <id> --state needs-human
agentic-account account connect --id <id> --provider direct --credential-ref vault://team/instagram
agentic-account account warmup --id <id>

advance 会让账号依次经过 planned → creating → verifying → profile → connecting → warming → active，如果平台要求证明操作者是人，则会进入 paused 或 needs-human。

CLI

agentic-account account create --platform <name> --handle <handle> [--email-ref <ref>] [--phone-ref <ref>]
agentic-account account list
agentic-account account show --id <id>
agentic-account account checklist --id <id>
agentic-account account advance --id <id> --state <state>
agentic-account account connect --id <id> --provider <provider> --credential-ref <ref>
agentic-account account warmup --id <id>
agentic-account costs
agentic-account mcp

库

import { AccountRegistry, platformRequirements } from "agentic-account";

const registry = new AccountRegistry();
const account = registry.create({ platform: "instagram", handle: "acme", emailRef: "BRAND_EMAIL" });
registry.advance(account.id);                    // planned -> creating
registry.advance(account.id, "needs-human");     // CAPTCHA / SMS / identity check

platformRequirements 涵盖 Instagram、TikTok、X、LinkedIn、Facebook、Reddit、Threads、Bluesky、YouTube 和 Pinterest；每个平台都包含清单、验证步骤和预热指南。

MCP 服务

agentic-account mcp（或 npx agentic-account-mcp）通过 stdio 提供注册表：account_create、account_list、account_show、account_checklist、account_advance、account_connect、account_warmup 和 get_cost_report。

使用场景

• 发布 Agent 跟踪同一品牌在十个平台上的账号，并准确指出每个账号卡在哪一步。
• 运维脚本生成各平台的账号设置清单，无需将清单保存在文档中。
• 团队保险库保存真实凭据；注册表只存储 env: 和 vault:// 引用。

替代方案和相关工具

• 社交媒体排程工具（Buffer、Hootsuite、Later）负责向你已有的账号发布内容；此工具包跟踪的是账号创建、验证和连接工作。
• 密码管理器用于保存凭据；agentic-account 只引用凭据，不存储机密。

安全

• 它不会创建账号，也不会绕过平台检查——CAPTCHA、短信验证码和身份验证始终需要人工处理，并进入 needs-human 状态。
• 凭据字段只接受 BRAND_EMAIL、env:BRAND_EMAIL 或 vault://team/social 等引用；原始机密会被拒绝。
• 请遵守各平台的服务条款；部分平台完全禁止自动创建账号。

限制

• 进程内 CLI 注册表适用于引导式会话；如需持久化记录，请使用库并自行存储。
• 清单描述的是记录的平台版本所对应的要求——平台可能会在未通知的情况下更改流程。

许可证

MIT