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

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

Security Scan

The skill's instructions match its stated ad-management purpose, but it fails to declare the required auth token and lacks source/homepage trust signals — proceed only after verifying the external service and how credentials are provided.

Purpose & Capability

The SKILL.md describes Facebook ad creation, targeting, assets, budgeting and monitoring via a third-party MCP endpoint (https://baiz.ai/mcp), which matches the skill name and description. Requiring a Bearer token for the MCP API is reasonable for this purpose. However, the skill metadata declares no required credentials even though the runtime instructions clearly require an Authorization token.

Instruction Scope

Runtime instructions explicitly send JSON-RPC requests (via curl) to https://baiz.ai/mcp with an Authorization: Bearer {TOKEN} header and include ad copy, targeting, and asset URLs. The instructions do not reference reading local files or unrelated environment variables, but they do direct potentially sensitive ad content and account identifiers to an external service. They also do not specify how the token is supplied (env var, secret store, or interactive input).

Install Mechanism

No install spec and no code files are present (instruction-only). This minimizes local disk writes and executable installation risk.

Credentials

SKILL.md requires a Bearer auth token (format shown as '2524|xxx') to call the MCP API, but the skill metadata lists no required environment variables or primary credential. That mismatch is a security and usability concern: the agent will need a token but the skill does not declare how it should be provided or stored. No other unrelated credentials are requested.

Persistence & Privilege

The skill is not always-on (always: false) and does not request elevated platform persistence. Autonomous invocation is allowed by default but is not combined with additional privileges.

What to consider before installing

This skill calls a third-party API (https://baiz.ai/mcp) to manage Facebook ads and requires a Bearer token, but the skill metadata does not declare that credential or explain how to provide it. Before installing: verify the provider (baiz.ai) and the publisher (no homepage/source provided), confirm how and where you'll store the Bearer token (avoid pasting tokens into chats), ask the publisher to declare a required env var/primary credential and a privacy/terms link, and test in an isolated account. If you can't verify the service or are uncomfortable sharing ad/account data with baiz.ai, do not install.

Yuri Ad Platform API

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

基础配置

• Base URL: https://baiz.ai/mcp
• Auth: Bearer Token (格式: 2524|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	347631 (系统内部), 906345468747732 (FB)
主页ID	344542 (All In Tech Labs Limited)

广告状态码

• 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 - 发布广告