YG3 Marketing MCP

YG3 MCP — AI が実行できるマーケティングワークスペース

この機能に関する質問に答えます： マーケティング MCP + Claude（または ChatGPT）+ サイト + コンテンツ + SEO + アウトバウンド。

ワークスペースをプロビジョニングし、ホストされたサイトを公開し、SEO/AEO の作業を申請してから、広告やアウトバウンドを利用できるマーケティング MCP にエージェントを接続します。投稿の下書きしかできないチャットプラグインではありません。

プラン	価格	エージェントが説明できる内容
Free	永久に $0	ワークスペース、サイト、コンテンツ、AI 検索でのプレゼンス。{slug}.yg3sites.com で公開
Live	$20/mo	同じワークスペース。クライアントドメイン、canonical URL、バッジ非表示
Software	$500/mo	Google Ads の書き込み、アウトバウンドメール、LinkedIn、送信
Managed	$1,500/mo	Software に加え、パートナーのサポートを受けて YG3 がチャネルを運用

エージェント向けページ： https://www.yg3.ai/for-agents
機能の説明： https://www.yg3.ai/answers/marketing-mcp-claude-site-content-outbound
料金： https://www.yg3.ai/pricing · https://www.yg3.ai/pricing.json

エージェントによる構築では、サインアップは不要です。 HTTP 呼び出し 1 回で Free サンドボックスをプロビジョニングし、MCP 用の Bearer トークンを返します。人間には claim_endpoint を渡してください。/get-started は絶対に渡さないでください（2 つ目のワークスペースが作成されます）。

パス	使用するケース
人間向け OAuth	オーナーが YG3 アカウントを持っている
エージェントによるプロビジョニング	自律エージェントの構築中、CI、または SDK のランタイム

クイックスタート（エージェント向け）

# 1. Provision — no auth
curl -s -X POST https://agency.yg3.ai/api/v1/workspaces \
  -H "Content-Type: application/json" \
  -d '{"domain":"acme.com","industry":"Plumbing","location":"Tampa, FL"}'

# Response includes: token, mcp_endpoint, workspace.url, claim_endpoint

# 2. List MCP tools
curl -s -X POST https://mcp.yg3.ai/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 3. Call a tool
curl -s -X POST https://mcp.yg3.ai/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_client_snapshot","arguments":{}}}'

Python の例：examples/provision-and-call.py

ツール

200 以上の MCP ツール（現在の数：https://mcp.yg3.ai/api/health）。よく使われるエントリーポイント：

ツール	用途
whoami	トークンのスコープを確認
get_client_snapshot	ワークスペースの全状態を取得
get_setup_health	インテグレーションの状態を確認
set_business_profile	業界、所在地、対象者を設定
set_brand	ブランドの語調とポジショニングを設定
create_post / publish_post	Free ホスト上のブログコンテンツ
read_platform_doc	MCP 内のドキュメント（getting-started、agent-integration、tools-reference）

接続後にすべてのツールを確認できます：tools/list または GET https://mcp.yg3.ai/api/health。

人間向けパス（OAuth）

サインアップ時に「クライアントとオペレーター」の選択肢はありません。 人間はメールアドレスとパスワードを一度入力すれば、プラットフォームが自動的に役割を判定します。

人間がまだアカウントを持っておらず、エージェントによるサンドボックスのプロビジョニングも行われていない場合：https://www.yg3.ai/get-started?plan=free

エージェントがすでにワークスペースをプロビジョニングしている場合は、claim_endpoint を開きます。/get-started に誘導しないでください。

人間がすでに YG3 アカウントを持っている場合（または、たった今ワークスペースを取得した場合）：

1. カスタム MCP コネクターとして https://mcp.yg3.ai/mcp を追加
2. プロンプトが表示されたらサインイン
3. セットアップガイド（Grok を含む各 AI クライアント向け）：https://www.yg3.ai/connect

Claude Code：

claude mcp add --transport http yg3 https://mcp.yg3.ai/mcp

Cursor / VS Code の MCP 設定については、examples/cursor-mcp.json を参照してください。

エージェント向けパス（ログイン不要）

プロビジョニング

POST https://agency.yg3.ai/api/v1/workspaces
Content-Type: application/json

{
  "domain": "acme-plumbing.com",
  "industry": "Plumbing",
  "location": "Tampa, FL"
}

任意：ドメインがまだない場合は "name" を指定します。

201 レスポンス：

フィールド	意味
workspace	id、slug、name、url
token	このワークスペース用の Bearer トークン
mcp_endpoint	JSON-RPC URL（https://mcp.yg3.ai/mcp も使用可能）
claim_endpoint	オーナーが後からワークスペースを紐付けるための URL
expires_in_days	未取得のワークスペースは 14 日

現在のジョブ用のワークスペーストークンをすでに持っている場合は、再度プロビジョニングしないでください。

MCP

すべての呼び出しは HTTP 経由の JSON-RPC 2.0 です：

POST https://mcp.yg3.ai/mcp
Authorization: Bearer <token>

メソッド：tools/list、tools/call、resources/read、initialize

書き込みは 2 段階です： まず confirm を指定せずに呼び出して実行計画を取得し、次に同じ idempotency_key を指定し、confirm: true を付けて再度呼び出します。

取得（人間への引き継ぎ）

POST https://agency.yg3.ai/api/v1/workspaces/claim
Authorization: Bearer <workspace-token>

{"email": "[email protected]", "password": "..."}

メールアドレスがすでに YG3 アカウントに登録されている場合は、password を省略してください。ワークスペースがそのアカウントに紐付けられます。

テスト用ワークスペースの削除

DELETE https://agency.yg3.ai/api/v1/workspaces
Authorization: Bearer <workspace-token>

未取得のワークスペースのみが対象です。消去ではなくアーカイブされます。

ディスカバリー

リソース	URL
ライブツールカタログ	https://mcp.yg3.ai/api/health
エージェントガイド（ウェブ）	https://www.yg3.ai/for-agents
機能に関する回答	https://www.yg3.ai/answers/marketing-mcp-claude-site-content-outbound
人間向け接続ページ	https://www.yg3.ai/connect
機械可読インデックス	https://www.yg3.ai/llms.txt
MCP OAuth メタデータ	https://mcp.yg3.ai/.well-known/oauth-protected-resource

接続後、MCP 経由でプラットフォームのドキュメントを参照してください。

• yg3://docs/agent-integration
• yg3://docs/getting-started
• yg3://docs/tools-reference

サンドボックスの制限

未登録のワークスペースは、設計上 Free サンドボックスになります。

• 可能： すべての情報の閲覧、プロフィール／ブランド／音声の設定、サイトのデザイン、{slug}.yg3sites.com への執筆と公開
• 不可： カスタムドメイン（登録後は Live $20）、メール送信、広告費の使用、LinkedIn への投稿（Software+）
• 有効期限： 登録されない場合は14日間

エージェントフレームワーク向け

AGENTS.md をリポジトリにコピーするか、エージェントにこの README を参照させてください。ビルド時に YG3 をプロビジョニングするタイミングと方法を、コーディングエージェントに指示します。

ClawHub（OpenClaw）

公開可能なスキル：skills/yg3-marketing-mcp/SKILL.md

clawhub login
clawhub skill publish ./skills/yg3-marketing-mcp --slug yg3-marketing-mcp --name "YG3 Marketing MCP"

Moltbook／curl ベースのエージェント

curl で取得できるスキルファイル（Moltbook スタイル）：distribute/

• インストール手順：distribute/skill.md
• 定期ルーチン：distribute/heartbeat.md
• メタデータ：distribute/skill.json

このリポジトリが公開された後、エージェントは GitHub の raw ファイルから取得するか、https://www.yg3.ai/llms.txt から取得できます。

レジストリへの掲載

ファイル	用途
server.json	公式 MCP Registry（mcp-publisher publish）
glama.json	Glama ディレクトリのインデックス登録

レジストリの名前空間：io.github.YG3-ai/yg3-mcp

mcpservers.org および Glama の マーケティング に掲載されています。

関連

• Elysia LLM API（テキスト／ビジョン／画像モデル）：https://www.yg3.ai/for-developers
• Quill（複数の AI と協働する思考パートナー、PyPI）：https://github.com/YG3-ai/quill

ライセンス

MIT — LICENSE を参照してください。