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

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

Security Scan

The skill's instructions legitimately describe a Facebook ad management API hosted at baiz.ai, but it omits declaring the required authentication/credentials and has no provenance (source/homepage), which is an inconsistency that raises concern before installing.

Purpose & Capability

The name/description (Facebook ad creation, management, monitoring) match the SKILL.md which documents API calls for campaigns, adsets, creatives, budgets, etc. The requested operations are coherent with the stated purpose.

Instruction Scope

SKILL.md is instruction-only and instructs the agent to call a single external endpoint (https://baiz.ai/mcp) via curl with JSON-RPC payloads. It does not instruct reading local files or unrelated system paths. The scope of actions (create/adjust/publish ads) aligns with the stated purpose.

Install Mechanism

No install spec or code is included (instruction-only), so nothing will be written to disk by an installer. This is low install risk.

Credentials

The runtime examples require an Authorization: Bearer {TOKEN} header, but the skill metadata declares no required env vars or primary credential. That mismatch (a network service that clearly needs a secret token but doesn't declare it) is a red flag. The skill also has no provenance (source/homepage) to explain how tokens are obtained or scoped.

Persistence & Privilege

The skill is user-invocable and can be invoked autonomously (platform default). Given it performs high-impact actions (creating/publishing/stopping ads, changing budgets) against an external ad platform, autonomous invocation combined with missing provenance and undeclared credential handling increases risk if you don't fully trust the endpoint/operator. always:false mitigates some risk but does not eliminate it.

What to consider before installing

This skill appears to legitimately wrap a third‑party ad API (baiz.ai) but omits important provenance and credential declarations. Before installing: (1) confirm who runs baiz.ai and verify a homepage/repo or privacy/security policy; (2) require the skill owner to declare the primary credential (how the Bearer token is supplied) and recommend using a least-privilege token scoped to a test/sandbox ad account; (3) do not provide high-privilege/production Facebook tokens until you trust the operator; (4) consider testing with a disposable/sandbox account and monitor API activity and billing closely; (5) if you cannot verify the operator or token handling, do not install or use this skill.

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