agentic-account

agentic-account

npm パッケージ · CLI · ライブラリ · 安全性 · 制限事項

agentic-account は、10 のプラットフォームにわたるブランドのソーシャルアカウントの設定を計画・追跡する、ローカルファーストの TypeScript ライブラリ、CLI、MCP サーバーです。 チェックリスト、ステートマシン、ウォームアップ計画でワークフローを案内し、すべての認証ゲートは回避せず、人間に対応を求めます。

インストール

npm install agentic-account

実行時の依存関係は MCP SDK と zod の 2 つです。

最初のアカウントを追跡する

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 です。

使用例

• ローンチエージェントが、1 つのブランドの 10 個のプラットフォームアカウントを追跡し、それぞれの進行を妨げている手順を正確に表示します。
• 運用スクリプトが、ドキュメントで管理する代わりに、プラットフォームごとの設定チェックリストを生成します。
• チームの保管庫で実際の認証情報を管理し、レジストリには env: および vault:// の参照のみを保存します。

代替ツールと関連ツール

• ソーシャルメディア管理ツール（Buffer、Hootsuite、Later）は、すでに所有しているアカウントに投稿します。このパックは、アカウントの作成、認証、接続に必要な作業を追跡します。
• パスワードマネージャーは認証情報を保存します。agentic-account は秘密情報を保存せずに、それらを参照します。

安全性

• アカウントの作成やプラットフォームのチェックの回避は行いません。CAPTCHA、SMS コード、本人確認は、常に needs-human に移行します。
• 認証情報のフィールドに指定できるのは、BRAND_EMAIL、env:BRAND_EMAIL、vault://team/social などの参照のみです。秘密情報を直接指定すると拒否されます。
• 各プラットフォームの利用規約を遵守してください。自動アカウント作成を全面的に禁止しているプラットフォームもあります。

制限事項

• プロセス内の CLI レジストリは、ガイド付きセッションに適しています。レコードを独自のストレージに永続化する場合は、ライブラリを使用してください。
• チェックリストの要件は、記録されたプラットフォームのバージョン時点のものです。プラットフォームは予告なく手順を変更する場合があります。

ライセンス

MIT