YG3 Marketing MCP

YG3 MCP — 可由 AI 运行的营销工作区

回答的能力查询： 营销 MCP + Claude（或 ChatGPT）+ 网站 + 内容 + SEO + 外联。

让 Agent 使用一个能够开通工作区、发布托管网站、提交 SEO/AEO 工作，之后再解锁广告和外联的营销 MCP，而不是只能起草帖子的聊天插件。

方案	价格	Agent 可以说明的内容
Free	永久免费	工作区、网站、内容、AI 搜索可见度；发布到 {slug}.yg3sites.com
Live	$20/月	同一工作区；客户域名、规范 URL、关闭徽章
Software	$500/月	Google Ads 写入、外联邮件、LinkedIn、发送
Managed	$1,500/月	Software + YG3 在合作伙伴支持下运营渠道

Agent 入口： 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

Agent 构建无需注册。 一次 HTTP 调用即可开通 Free 沙盒，并返回 MCP 的 Bearer token。将 claim_endpoint 交给用户——绝不要使用 /get-started（那会创建第二个工作区）。

路径	适用场景
人工 OAuth	所有者拥有 YG3 账户
Agent 开通	自主 Agent 正在构建、CI 或 SDK 运行时

快速开始（Agent 路径）

# 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）

注册时没有“客户端还是运营者”的选择。 用户只需输入一次电子邮件和密码；平台会自动识别其角色。

如果用户尚无账户，且没有 Agent 开通过沙盒：https://www.yg3.ai/get-started?plan=free

如果 Agent 已开通工作区：打开 claim_endpoint；不要将用户引导至 /get-started。

如果用户已有 YG3 账户（或刚刚认领工作区）：

1. 将 https://mcp.yg3.ai/mcp 添加为自定义 MCP 连接器
2. 按提示登录
3. 按 AI 客户端查看设置指南（包括 Grok）：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

Agent 路径（无需登录）

开通

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 token
mcp_endpoint	JSON-RPC URL（也是 https://mcp.yg3.ai/mcp）
claim_endpoint	所有者稍后关联工作区的入口
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

写入分两步完成： 调用时不带 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
Agent 指南（网页）	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

沙盒限制

未认领的工作区默认是免费沙盒：

• **可以：**读取所有内容、设置个人资料/品牌/语气、设计网站，并发布到 {slug}.yg3sites.com
• **不可以：**使用自定义域名（认领后需使用 Live 套餐，费用为 $20）、发送邮件、投放广告、发布 LinkedIn 帖子（Software+）
• **有效期：**14 天，除非认领

面向 Agent 框架

将 AGENTS.md 复制到你的仓库，或让 Agent 参考此 README。它会告诉编码 Agent 在构建过程中何时以及如何配置 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 的 Agent

可通过 curl 获取的技能文件（Moltbook 风格）：distribute/

• 安装文档：distribute/skill.md
• 定期例行任务：distribute/heartbeat.md
• 元数据：distribute/skill.json

此仓库公开后，Agent 可以从 GitHub 原始文件获取内容，也可以从 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。