Yuri广告平台 MCP API - Facebook广告创建、投放管理、数据监控。支持创建Campaign/Ad Set/Ad、查询余额、受众定位、文案素材管理、预算调整等

Yuri广告平台 MCP API - Facebook广告创建、投放管理、数据监控。支持创建Campaign/Ad Set/Ad、查询余额、受众定位、文案素材管理、预算调整等。

Security Scan

The skill's instructions coherently describe managing Facebook ads via a third-party MCP endpoint, but it requires a bearer token (a secret) while the registry metadata declares no required credentials — an unexplained mismatch.

Purpose & Capability

The SKILL.md consistently describes Facebook ad management via the baiz.ai MCP API (creating campaigns, audiences, assets, monitoring, etc.), which matches the skill name and description. However, the runtime instructions require an Authorization Bearer token for baiz.ai even though the skill metadata declares no required credentials — this is an incoherence (the skill legitimately needs a secret but doesn't declare it).

Instruction Scope

Instructions are narrowly scoped to JSON-RPC calls to https://baiz.ai/mcp and do not ask the agent to read unrelated files or system paths. The instructions do expect a Bearer token and show concrete RPC payloads, but they do not explain where the token comes from or how it should be provided, which is an omission that affects safe use.

Install Mechanism

This is an instruction-only skill with no install spec and no code files, so nothing is written to disk and there is no installer risk.

Credentials

The skill clearly requires a Bearer token for the baiz.ai MCP API, but requires.env and primary credential fields are empty. Requesting a secret for a third-party API is reasonable for an ad-management skill, but the missing declaration is disproportionate and reduces transparency — the agent/platform won't automatically know which secret to collect or how to scope it.

Persistence & Privilege

The skill is not always-enabled and has no install-time persistence. It does allow autonomous invocation by default (platform default), which is normal; there is no evidence the skill modifies other skills or system-wide settings.

What to consider before installing

This skill appears to be what it claims (Facebook ad management via a third-party MCP), but it omits a declared credential: the SKILL.md requires a baiz.ai Bearer token while the registry lists no required env vars or primary credential. Before installing or enabling autonomous use: 1) Verify the operator/domain (https://baiz.ai) and ask the provider for documentation and the exact token-scoping rules. 2) Do not reuse high-privilege or long-lived Facebook/manager tokens — use least-privilege tokens scoped to a test account first. 3) Ask the skill author to declare the required env var/primary credential in metadata so the platform can prompt for it explicitly. 4) If you must test, do so with a non-production account and limit budget/permissions. 5) Avoid enabling automatic/autonomous invocation until you confirm the token handling and trust the third party.

Yuri Ad Platform API

通过 curl 调用 baiz.ai MCP API 管理 Facebook 广告。

基础配置

• Base URL: https://baiz.ai/mcp
• Auth: Bearer Token (格式: xxx|xxx)

通用调用格式

curl -s "https://baiz.ai/mcp" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"TOOL_NAME","arguments":{ARGUMENTS}},"id":1}'

核心工具

1. 查询余额

{"name":"get_balance","arguments":{}}

2. 广告账户

# 列出BM
{"name":"list_businesses","arguments":{}}

# 列出广告户 (bm_id 从 list_businesses 获取)
{"name":"list_ad_accounts","arguments":{"bm_id":44723}}

# 列出主页
{"name":"list_pages","arguments":{}}

3. Offer 管理

# 创建 Offer
{"name":"create_offer","arguments":{"name":"产品名称","url":"https://...","price":29.99}}

# 列出 Offers
{"name":"list_offers","arguments":{}}

4. 受众定位

# 创建受众
{"name":"create_targeting","arguments":{"name":"受众名称","countries":["US"],"gender":"all","min_age":25,"max_age":55}}

# 列出受众
{"name":"list_targetings","arguments":{}}

5. 文案

# 创建文案
{"name":"create_copywriting","arguments":{"name":"文案名称","primary_text":"正文","headline":"标题","description":"描述"}}

# 列出文案
{"name":"list_copywritings","arguments":{}}

6. 素材

# 通过URL上传
{"name":"create_file","arguments":{"url":"https://...","name":"文件名","tag":"标签"}}

# 列出素材
{"name":"list_files","arguments":{}}

7. 广告计划

# 创建 Campaign
{"name":"create_campaign","arguments":{
  "name": "广告名称",
  "objective": "OUTCOME_SALES",
  "call_to_action_type": "LEARN_MORE",
  "start_time": "2026-03-16 17:00:00",
  "end_time": "2026-03-23 23:59:59",
  "selected_hours": ["0-23"],
  "copywriting_ids": [文案ID],
  "targeting_ids": [受众ID],
  "file_ids": [素材ID],
  "offer_ids": [OfferID],
  "facebook_business_id": BM系统ID,
  "facebook_page_id": 主页系统ID,
  "ad_account_ids": [广告户系统ID],
  "budget_type": "daily",
  "limit_daily_amount": 20
}}

# 列出 Campaigns
{"name":"list_campaigns","arguments":{}}

# 获取 Campaign 详情
{"name":"get_campaign","arguments":{"id": CampaignID}}

# 发布 Campaign
{"name":"publish_campaign","arguments":{"id": CampaignID}}

# 暂停 Campaign
{"name":"stop_campaign","arguments":{"id": CampaignID}}

# 启动 Campaign
{"name":"start_campaign","arguments":{"id": CampaignID}}

# 调整预算
{"name":"adjust_budget","arguments":{"id": CampaignID, "action": "increase|decrease|set", "amount": 20}}

8. 数据监控

# 广告级别数据
{"name":"list_campaign_ads","arguments":{"id": CampaignID}}

# 广告组级别数据
{"name":"list_campaign_adsets","arguments":{"id": CampaignID}}

# 暂停/启动广告组
{"name":"update_adset_status","arguments":{"id": CampaignID, "adset_id": "FB广告组ID", "status": "PAUSED|ACTIVE"}}

9. 扩量

# 复制整个Campaign
{"name":"copy_campaign","arguments":{"id": CampaignID}}

# 复制广告组
{"name":"copy_adset","arguments":{"id": CampaignID, "adset_id": "FB广告组ID"}}

常用ID速查

类型	示例ID
BM ID	44723 (Yuri-212-08261204)
广告户ID	339910 (系统内部), 1919376461994756 (FB)
主页ID	17623 (Jadiel Manuel Juan Emmitt)

广告状态码

• 0: 草稿
• 1: 审核中
• 2: 投放中
• 3: 被拒
• 4: 不盈利
• 5: 预算耗尽
• 6: 归档
• 7: 已停止
• 8: 已禁用
• 9: 已过期
• 10: 失败

使用示例

创建广告流程：

1. get_balance - 检查余额
2. list_businesses + list_ad_accounts + list_pages - 获取BM/广告户/主页
3. create_offer - 创建Offer
4. create_targeting - 创建受众
5. create_copywriting - 创建文案
6. create_file - 上传素材
7. create_campaign - 创建广告计划
8. publish_campaign - 发布广告