ShapelessAI

ShapelessAI

ShapelessAI はソーシャルプレゼンスを管理します。接続したプラットフォームに投稿するコンテンツを作成、スケジュール設定、公開し、ブランドメモリーを保持し、常駐エージェントを稼働させ続けます。

このリポジトリは、shapeless CLI、MCP サーバー、Claude Code プラグイン、イシュートラッカーからなるエージェント向けインターフェースの公開リポジトリです。エージェントやスクリプトを使って ShapelessAI アカウントを操作し、投稿の作成やスケジュール設定、ジョブの作成と停止したジョブの再開、承認と公開、ブランドメモリーの編集、常駐エージェントの管理ができます。

ドキュメントは shapelessai.com/docs にあります。ルート、スコープ、プラットフォームごとの制限、拒否コードを、項目ごとに解説しています。各ページでは生の Markdown も取得できます。パスに .md を追加する（https://shapelessai.com/docs/posts.md）か、Accept: text/markdown を送信してください。ドキュメント全体を一度に取得したいエージェントは、shapelessai.com/llms-full.txt を参照してください。

インストール

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

Node 20 以降が必要です。

認証

スタジオの Settings -> API keys（/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 を確認してください。

無料プラン：キューに登録できる投稿は 1 日 10 件です。各投稿を公開する UTC 日にカウントされるため、1 週間先まで計画する場合も、合計 10 件ではなく 1 日 10 件です。11 件目は 402 {code: "free_daily_cap", limit, day, resetsAt} を返し、上限に達した日が示されます。投稿の作成、スケジュール設定、公開でクレジットが消費されることはありません。また、無料プランにはエージェントチーム用の月額 5 ドル分のクレジットも含まれています。有料プランには上限がありません。詳細はshapelessai.com/docs/postsをご覧ください。

ジョブ：永続的な実行

ジョブは、接続を維持しているかどうかにかかわらずサーバーが実行を続ける処理です。エージェントや 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://...

エージェント、ブランドメモリー、アセット

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 ジョブ、セルフホスト型エージェント）は 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 は shapeless login の API キーを使って stdio で MCP を提供し、ディスクを読み取るツール（assets_upload、brain_import、ジョブメッセージの files）も追加します。すべてのツールにはタイトルと注釈が付いています。読み取り専用のツールは自由に実行でき、公開、消費、上書きを行うものには破壊的操作のフラグが付くため、ホストが事前に確認します。また、各ツールの説明には必要なスコープが記載されています。

アカウント用ツールに加え、当社のスタジオエージェントが備えるすべてのツールも、それぞれ独立した 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 で最新の情報を取得できます。

ジョブは会話であるため、作業内容はターミナルとウェブアプリの間で双方向に受け渡せます。

• すべてのジョブ結果には url（https://shapelessai.com/studio/c/<id>）が含まれるため、エージェントは実行した内容へのリンクを人に渡せます。
• jobs_brief <id> は、返信前に使える低コストの読み取りツールです。直近 30 件のメッセージを抜粋し、推論とツールのアクティビティを除外したうえで、成果物の一覧とキューステータスごとの投稿数を返します。決定論的に動作し、モデルは介在しません。jobs_get では引き続き会話の全履歴を取得できます。
• jobs_list は新しい順に 1 回あたり 200 件のジョブを返し、nextCursor を含みます。これを before として渡すと、さらに過去の履歴をたどれます。
• jobs_tail <id> はジョブの実行を監視し（最大 60 秒、200 イベント）、イベントと再開用のカーソルを返します。アタッチできる実行ストリームがないジョブでは、エラーの代わりに {live: false} を返します。
• jobs_create と jobs_continue はファイルを受け取れます。files（絶対ローカルパス。.md／.txt はインラインで送信され、画像、動画、音声、PDF はここからアップロードされます）と mediaKeys（assets_upload の返却値など、すでにアカウントにあるもの）を指定します。1 メッセージにつき最大 6 個までです。ファイルはスタジオで人が見るメッセージに添付され、エージェントも実際に読み取ります。画像の場合、そのターンではファイル名だけでなくピクセルデータがインラインで渡されます。

プロンプトは continue（引数：id）の 1 つだけです。Claude Code ではスラッシュコマンドとして表示されます。このプロンプトは会話の概要を読み込み、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 で保存したキーを使用します。

エージェントプラグイン（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：Official MCP Registry（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、3 つの基本操作
/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 は上記の仕様に基づいて開発されています。このリポジトリでリリースしています。
• プライバシーポリシー：shapelessai.com/privacy
• 利用規約：shapelessai.com/terms