跳转到 MCP 内容

给 AI 的广告研究接入说明

为你的 AI 安装 PipiAds MCP 或 CLI

连接你的 AI,用对话研究广告、商品与竞品。

1

安装 PipiAds MCP

在 ChatGPT 桌面端的本地 Work 中添加 PipiAds MCP。

需要 Node.js 20+ · API Key ↗

查看安装配置

在 ChatGPT 桌面端打开 Settings → MCP servers → Add server,选择 STDIO。命令填 npx,参数填 -y 和 pipiads-mcp-server,添加环境变量 PIPIADS_API_KEY。也可将下方 TOML 添加到配置文件。

config.toml
~/.codex/config.toml
[mcp_servers.pipiads]
command = "npx"
args = ["-y", "pipiads-mcp-server"]

[mcp_servers.pipiads.env]
PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"

在本地配置中替换 YOUR_PIPIADS_API_KEY。请妥善保管密钥,不要提交到 Git。

已有配置?查看合并方式

将下方配置添加到 ~/.codex/config.toml,保留已有设置。如果已存在 [mcp_servers.pipiads],请更新该配置,不要重复添加。ChatGPT 桌面端与 Codex 在同一主机上共用此文件。

官方接入文档 ↗
2

在 ChatGPT 中开始研究

保存并重启 MCP 服务,在本地 Work 对话中开始研究广告。

开始研究
查看其他 MCP 客户端配置

Claude Desktop

在 Claude Desktop 中打开 Settings → Developer → Edit Config,将配置保存到下方路径。

mac: ~/Library/Application Support/Claude/claude_desktop_config.json

windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pipiads": {
      "command": "npx",
      "args": ["-y", "pipiads-mcp-server"],
      "env": {"PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"}
    }
  }
}

完全退出并重新打开 Claude Desktop,开启新对话,检查 PipiAds 工具是否可用。

已有其他 MCP 服务?只需将 pipiads 条目合并到现有的 mcpServers 中,保留其他配置。

ChatGPT

在 ChatGPT 桌面端打开 Settings → MCP servers → Add server,选择 STDIO。命令填 npx,参数填 -y 和 pipiads-mcp-server,添加环境变量 PIPIADS_API_KEY。也可将下方 TOML 添加到配置文件。

all: ~/.codex/config.toml

[mcp_servers.pipiads]
command = "npx"
args = ["-y", "pipiads-mcp-server"]

[mcp_servers.pipiads.env]
PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"

保存后在 MCP servers 中点击 Restart。开启本地 Work 任务,输入 /mcp 检查 pipiads 连接,然后尝试下方的研究示例。

将下方配置添加到 ~/.codex/config.toml,保留已有设置。如果已存在 [mcp_servers.pipiads],请更新该配置,不要重复添加。ChatGPT 桌面端与 Codex 在同一主机上共用此文件。

Codex

使用 Codex 应用时,将下方 TOML 添加到 ~/.codex/config.toml 并替换 API Key 占位符。CLI 与 IDE 扩展共用此配置;如果使用 CLI,也可选择执行下方命令。

all: ~/.codex/config.toml

[mcp_servers.pipiads]
command = "npx"
args = ["-y", "pipiads-mcp-server"]

[mcp_servers.pipiads.env]
PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"

重新启动 Codex 应用,在 MCP servers 设置中检查 PipiAds。CLI 用户可开启新会话并通过 /mcp 检查连接,codex mcp list 可查看已保存的配置。

将下方配置添加到 ~/.codex/config.toml,保留已有设置。如果已存在 [mcp_servers.pipiads],请更新该配置,不要重复添加。ChatGPT 桌面端与 Codex 在同一主机上共用此文件。

Claude Code

在项目终端中执行以下命令,执行前请替换 API Key 占位符。该命令会将服务添加到 Claude Code。

claude mcp add pipiads -e PIPIADS_API_KEY=YOUR_PIPIADS_API_KEY -- npx -y pipiads-mcp-server

运行 claude mcp list 检查服务,再在该项目中启动 Claude Code。使用 /mcp 查看连接状态。

Cursor

在项目根目录创建或打开 .cursor/mcp.json,添加下方配置并保存。

all: .cursor/mcp.json

{
  "mcpServers": {
    "pipiads": {
      "command": "npx",
      "args": ["-y", "pipiads-mcp-server"],
      "env": {"PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"}
    }
  }
}

打开 Cursor Settings → Tools & MCP(部分版本名称为 MCP),启用 pipiads,必要时重启 Cursor,然后使用 Agent 对话。

已有其他 MCP 服务?只需将 pipiads 条目合并到现有的 mcpServers 中,保留其他配置。

Windsurf

打开 MCP 配置文件并添加 PipiAds。以下路径相对于你的用户主目录。

all: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pipiads": {
      "command": "npx",
      "args": ["-y", "pipiads-mcp-server"],
      "env": {"PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"}
    }
  }
}

在 Windsurf 中刷新 MCP 服务或重启应用,确认 Cascade 可以使用 pipiads。

已有其他 MCP 服务?只需将 pipiads 条目合并到现有的 mcpServers 中,保留其他配置。

OpenClaw

在 ~/.openclaw/openclaw.json 的 mcp.servers 中添加 pipiads,保留已有配置。此示例适用于支持原生 MCP 的 OpenClaw 版本。

all: ~/.openclaw/openclaw.json

{
  "mcp": {
    "servers": {
      "pipiads": {
        "command": "npx",
        "args": [
          "-y",
          "pipiads-mcp-server"
        ],
        "env": {
          "PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"
        }
      }
    }
  }
}

运行 openclaw mcp list 确认已保存 pipiads;这不代表已连接成功。按照实际使用该配置的 Gateway 或 Agent 进程的重载或重启流程使配置生效。如需单独验证工具发现,先停止本地 Gateway,再运行 openclaw mcp probe pipiads,随后重新启动 Gateway,并在新的 Agent 对话中确认可用的 PipiAds 工具。

将 pipiads 条目合并到现有的 mcp.servers 中,保留其他服务和设置;不要添加顶层 mcpServers。

其他客户端

使用支持本地 stdio MCP 的客户端。命令设为 npx,参数设为 -y 和 pipiads-mcp-server,环境变量 PIPIADS_API_KEY 设为你的密钥。不同客户端的 JSON 格式可能不同。

npx -y pipiads-mcp-server

在客户端重启或重新连接 MCP 服务。本软件包使用本地 stdio,不提供可直接填写的远程 HTTP 或 SSE 服务地址。

Grok Build

将下方配置添加到 ~/.grok/config.toml,并在本地填写 API Key。此方式用于 Grok Build。

all: ~/.grok/config.toml

[mcp_servers.pipiads]
command = "npx"
args = ["-y", "pipiads-mcp-server"]

[mcp_servers.pipiads.env]
PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"

在 Grok Build 中输入 /mcps,刷新 PipiAds 服务后开启对话。

将配置合并到 ~/.grok/config.toml,保留已有设置。如果已存在 [mcp_servers.pipiads],请更新该配置,不要重复添加。

1

发送给 Claude Code

请帮我安装 PipiAds CLI:
1. 检查 Node.js 版本,需要 20 或更高。
2. 执行 npm install -g pipiads-cli。
3. 运行 pipiads --help,确认安装成功。
4. 检查当前执行环境是否设置 PIPIADS_API_KEY,仅返回是否已设置,不要读取或输出密钥。未设置时提醒我在本地配置。
完成后告诉我;暂不执行付费查询。
2

连接后开始研究

在 AI 执行命令的环境中配置 API Key,然后让它搜索广告、发现商品或分析竞品。

配置 API Key 获取 API Key 与积分 ↗
export PIPIADS_API_KEY="YOUR_PIPIADS_API_KEY"
$env:PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"
开始研究

连接完成,开始第一次研究。

好问题,是好洞察的起点。

复制提示词到已连接的 AI 助手,按需调整市场、品类和时间范围。

试试这个问题

找到在美国投放超过 30 天的护肤广告,比较它们的创意开场。

展开示意报告收起示意报告
PipiAds · 广告研究
TikTok 和 Facebook美国市场投放超过 30 天
  • 产品演示

    先展示产品的使用动作,再解释核心卖点。

  • 痛点 → 解决方案

    从具体护肤困扰切入,再展示解决方式。

  • 创作者讲述

    以第一人称体验展开,观察叙事和证据如何配合。

比较开场钩子、产品卖点和落地页,为每个发现保留来源链接。

研究结果示意 · 实际发现以查询结果为准。

创意研究

找到值得研究的广告开场

使用 PipiAds 查找最近 30 天美国市场的 5 条活跃护肤 TikTok 广告,比较创意开场、投放天数与互动数据。附上来源链接,并区分数据事实与分析判断。

研究过程示意

给 AI 的范围

美国 · TikTok护肤 · 最近 30 天最多 5 条广告
比较开场与投放表现

让 AI 返回

  • 素材与来源链接
  • 投放天数与互动数据
  • 事实与创意判断分开

竞品研究

看懂一家店铺的广告策略

帮我用 PipiAds 分析一个竞争对手。先询问店铺域名、目标市场与日期范围,再研究其长期投放广告、主推商品和地区分布。报告中保留每个结论的来源。

研究过程示意

给 AI 的范围

竞品店铺域名目标市场日期范围
梳理店铺的投放策略

让 AI 返回

  • 长期投放的广告
  • 主推商品与地区分布
  • 带来源的研究结论

商品研究

建立有数据依据的选品清单

使用 PipiAds 查找最近 7 天美国 TikTok Shop 中销量增长的 5 款美妆商品,比较销量、GMV、价格与达人活跃度,并说明选品前还需要验证什么。

视觉发现

追踪一张图片背后的市场

帮我用 PipiAds 查找与图片相似的商品和广告。先询问公开图片链接,提交后检查搜索状态,完成后返回最多 5 个相似商品及来源链接。

查看四种研究任务的详细调用流程

每个流程先收集必要输入,再选择工具或命令,最后核对来源和费用。MCP 参数以 tools/list 为准,CLI 参数以对应 --help 为准。

广告创意研究

先确认
关键词、平台、地区、时间范围和最多返回条数。
MCP 顺序
search_ads → 从结果中选 ID → get_ad_detail。
CLI 顺序
pipiads adspy list --current-page 1 --page-size 5 --plat-type 1 --keyword skincare → pipiads adspy detail --id <返回的广告ID>
结果检查
列出素材链接、投放时间和互动数据;将事实与创意判断分开。

商品研究

先确认
商品关键词、平台、地区、时间范围和最多返回条数。
MCP 顺序
search_products → 从结果中选 ID → get_product_detail。
CLI 顺序
pipiads product list --current-page 1 --page-size 5 --plat-type 1 --keyword garden → pipiads product detail --id <返回的商品ID>
结果检查
保留商品来源、价格和广告数据,并标出仍需验证的选品假设。

竞品店铺研究

先确认
店铺域名或名称、市场、日期范围;缺少标识时先查找。
MCP 顺序
search_stores → get_store_detail → 按需调用 get_store_longest_run_ads。
CLI 顺序
pipiads store rank-list --data-type 0 --time 0 --sort 0 --sort-type desc --page-size 5 --current-page 1 --keyword example.com → pipiads store detail --id <返回的店铺ID>
结果检查
报告广告与商品重点,每条结论附来源,并区分数据与推断。

图片相似搜索

先确认
一张公开图片 URL 或本地图片文件,以及希望查找的对象。
MCP 顺序
ai_search_submit_image → ai_search_image_status → SEARCH_COMPLETED 后 ai_search_image_products;失败状态停止。
CLI 顺序
pipiads ai-search-image submit-url --image-url https://example.com/image.jpg → pipiads ai-search-image status --image-id <返回的image_id> → pipiads ai-search-image product-search --image-id <返回的image_id> --current-page 1 --page-size 5
结果检查
只在处理完成后返回匹配结果和来源;轮询失败时说明状态与下一步。

每次查询,心中有数。

MCP 软件包可免费安装;PipiAds API 按积分计费,AI 客户端可能单独收费。

列表与搜索

通常每条结果 1 积分

建议从少量结果开始,具体以接口规则为准。

广告与商品详情

通常每次请求 1 积分

部分接口支持 3 天内重复查询免费。

创建监控任务

每个成功创建的任务 1 积分

取消任务不会退还已经消耗的积分。

根据 API 文档,监控读取与设置、图片提交免费;图片搜索结果按对应接口规则计费。当前费用以 API 控制台为准。 获取 API Key 与积分 ↗

PipiAds 网站会员、AI 客户端订阅和 Open API 积分分开管理。Open API Key 与充值入口位于 Pipispy;若看不到密钥或余额,先在该入口确认账号权限。

了解你的新工具箱

完整的研究工具,一个 MCP 连接。

浏览所有已注册工具。AI 助手会根据任务选择工具,你也可以直接指定工具名称。

73个工具
CLI 命令发现

使用 pipiads --help 查看命令域,再用 pipiads <domain> <command> --help 查看必填参数。reference 域只输出文档元数据。

pipiads --help
pipiads adspy list --help
pipiads ai-search-image status --help
广告与自然流量视频读取

search_ads

搜索 TikTok / Facebook 广告。使用 extend_keywords 进行文本搜索,可按 AI 创意类型、投放状态、地区、互动数据、花费和日期筛选。每条结果 1 积分。

广告与自然流量视频读取

get_ad_detail

通过视频 ID 获取广告详情。每次查询 1 积分,3 天内重复查询免费。

商品读取

search_products

搜索在 TikTok / Facebook 投放广告的电商商品,可按关键词、价格、品类、地区和广告指标筛选。每条结果 1 积分。

商品读取

get_product_detail

获取商品详情,包括图片、价格、落地页和 Shopify 数据。每次查询 1 积分,3 天内重复查询免费。

商品读取

search_adlibrary_products

搜索 Meta 广告资料库中的商品,可按价格、平台、广告状态和投放天数筛选。每条结果 1 积分。

商品读取

get_adlibrary_product_detail

获取 Meta 广告资料库中的商品详情,包括店铺和广告主信息。每次查询 1 积分。

TikTok Shop读取

search_tiktok_products

搜索 TikTok Shop 商品,可按销量、成交总额(GMV)、价格、趋势和达人筛选。需提供 sort、sort_type 和 time。每条结果 1 积分。

TikTok Shop读取

get_tiktok_product_detail

获取 TikTok Shop 商品详情。每次查询 1 积分,3 天内重复查询免费。

TikTok Shop读取

search_tiktok_shops

搜索 TikTok Shop 店铺,可按销量、成交总额(GMV)、商品数量和达人筛选。

TikTok Shop读取

get_tiktok_shop_detail

通过店铺 ID 获取 TikTok Shop 店铺详情。

店铺与广告主读取

search_advertisers

搜索广告主排行榜,可按平台、地区、广告指标和月访问量筛选。

店铺与广告主读取

get_advertiser_detail

通过广告主 ID 获取详情,包括域名、广告数量、商品和地区分布。

店铺与广告主读取

search_stores

搜索店铺排行榜,可按平台、地区、广告指标和月访问量筛选。

店铺与广告主读取

get_store_detail

通过 13 位店铺 ID 获取店铺详情。

店铺与广告主读取

get_store_competition

获取店铺竞争分析可选的商品。

店铺与广告主读取

get_store_data_analysis

获取店铺在 TikTok、Facebook 和 Meta 的全平台数据分析。

店铺与广告主读取

get_store_play_cost

获取店铺的播放花费与每日广告增量统计。

店铺与广告主读取

get_store_region_analysis

获取店铺广告投放的地区分布分析。

店铺与广告主读取

get_store_ad_copy_analysis

分页获取店铺的 TikTok 广告文案分析。

店铺与广告主读取

get_store_ad_schedule

获取店铺的广告投放排期。

店铺与广告主读取

get_store_product_analysis

获取店铺的商品分析。

店铺与广告主读取

get_store_rank_data

获取店铺的流量排名数据。

店铺与广告主读取

get_store_ad_trend

获取店铺在 Meta 广告资料库中的广告趋势分析。需提供 start_time 和 end_time。

店铺与广告主读取

get_store_delivery_analysis

获取店铺在 Meta 广告资料库中的深度投放分析。

店铺与广告主读取

get_store_longest_run_ads

获取店铺在 Meta 广告资料库中投放时间最长的广告素材。

店铺与广告主读取

get_store_most_used_ads

获取店铺在 Meta 广告资料库中使用次数最多的广告素材。

店铺与广告主读取

get_store_fb_pages

获取店铺在 Meta 广告资料库中关联的 Facebook 广告主主页。

广告与自然流量视频读取

search_lib_ads

搜索 Meta 广告资料库中的广告,可按内容、平台、状态、花费、覆盖人数和投放天数筛选。

广告与自然流量视频读取

get_lib_ad_detail

通过广告 ID 获取 Meta 广告资料库中的广告详情。

排行榜读取

get_product_ranking

获取广告商品排行榜。需提供 sort_key、sort_type、time 和 type。

排行榜读取

get_new_product_ranking

获取新广告商品排行榜。需提供 found_time、sort_key、sort_type 和 type。

排行榜读取

get_app_ranking

获取热门应用排行榜。

排行榜读取

get_new_app_ranking

获取新应用排行榜。

排行榜读取

get_app_dev_ranking

获取热门应用开发者排行榜。

应用与开发者读取

search_apps

搜索在 TikTok / Facebook 投放广告的应用,可按品类、操作系统、下载量和收入筛选。

应用与开发者读取

get_app_detail

通过应用 ID 获取应用详情。

应用与开发者读取

search_app_developers

搜索应用开发者,可按应用数量、下载量和收入筛选。

应用与开发者读取

get_app_developer_detail

通过开发者 ID 获取应用开发者详情。

广告与自然流量视频读取

search_natural_videos

搜索 TikTok Made Me Buy It / 自然流量视频,可按播放量、点赞数和粉丝数筛选。

广告监控读取

search_fb_advertisers

按名称搜索 Facebook 广告主,用于创建监控任务。

广告监控写入

create_monitor_task

创建 Facebook 广告主或店铺 / 网站监控任务。每次仅提交一种目标列表,最多 50 个目标;每成功创建一个任务消耗 1 积分。不支持监控 TikTok。

广告监控读取

list_monitor_tasks

获取全部广告监控任务,支持按条件筛选。

广告监控读取

get_monitor_task_detail

通过任务 ID 获取监控任务详情。

广告监控写入

cancel_monitor_task

取消广告监控任务。

广告监控读取

get_monitor_board

获取广告监控任务的总览看板。

广告监控写入

set_monitor_task_group

将监控任务分配到指定分组。

广告监控读取

get_monitor_realtime_overview

获取监控任务的实时数据概览。

广告监控读取

get_monitor_daily_overview

获取监控任务的每日数据概览。

广告监控读取

get_monitor_landing_pages_overview

获取监控任务的落地页概览。

广告监控读取

get_monitor_latest_products

获取监控任务最新发现的广告商品。

广告监控读取

get_monitor_product_list

获取监控任务中的广告商品列表,支持按条件筛选。

广告监控读取

get_monitor_landing_page_list

获取监控任务中的落地页列表。

广告监控读取

get_monitor_ad_count_stats

获取监控任务的广告数量统计。

广告监控读取

get_monitor_deep_analysis

获取监控任务的广告投放深度分析。

广告监控读取

get_monitor_most_used_copy

获取监控任务中使用次数最多的广告文案。

广告监控读取

get_monitor_longest_run_copy

获取监控任务中投放时间最长的广告文案。

广告监控读取

get_monitor_ad_list

获取监控任务中的广告列表,支持多种筛选条件。

广告监控读取

get_monitor_ad_detail

通过广告 ID 获取监控任务中的广告详情。

广告监控读取

get_monitor_product_stats

获取监控任务中正在投放广告的商品统计。

广告监控写入

create_monitor_group

创建监控任务分组。

广告监控读取

list_monitor_groups

获取全部监控任务分组。

广告监控写入

update_monitor_group

修改监控任务分组的名称。

广告监控写入

delete_monitor_group

删除监控任务分组。

广告监控读取

get_monitor_notifications

获取当前的监控通知设置。

广告监控写入

save_monitor_notifications

保存监控通知设置,包括邮件、即时提醒和报告。

图片搜索写入

ai_search_submit_image

提交一张图片进行视觉搜索,使用公开图片链接或 Base64 图片,二者仅选其一。提交免费,返回图片 ID;获取结果前需轮询处理状态。

图片搜索读取

ai_search_image_status

查询已提交图片搜索的处理状态。

图片搜索读取

ai_search_image_summary

获取 AI 图片搜索的结果概览。

图片搜索读取

ai_search_image_ads

查找与已提交图片相似的广告。

图片搜索读取

ai_search_image_products

查找与已提交图片相似的商品。

图片搜索读取

ai_search_image_stores

查找与已提交图片相似的店铺或广告主。

图片搜索读取

ai_search_image_tiktok_products

查找与已提交图片相似的 TikTok Shop 商品。

图片搜索读取

ai_search_image_tiktok_shops

查找与已提交图片相似的 TikTok Shop 店铺。

开始之前,把问题说清楚。

关于接入,你可能想知道。

什么是 PipiAds MCP?

PipiAds MCP 通过模型上下文协议,将兼容的 AI 助手与 PipiAds 广告数据连接起来。你只需描述任务,助手即可调用工具搜索广告、研究商品和店铺,并使用广告监控数据。

支持哪些 AI 客户端?

MCP 安装区提供 ChatGPT 桌面端、本地 Claude Desktop、Cursor 和 Grok Build 的接入方式。CLI 可由 Claude Code、Codex、Cursor、OpenClaw、Hermes 等具备终端权限的 AI 使用。Grok 网页连接器需要远程服务地址,本软件包提供本地 stdio 服务。

需要 API Key 或付费套餐吗?

需要 PipiAds Open API Key,付费接口还需足够积分。PipiAds 网站会员或 AI 客户端订阅不等于 Open API 积分。Open API Key 与充值入口在 Pipispy,账号权限与余额请以该入口显示为准。

API Key 应该填在哪里?

MCP 在本地客户端配置的 PIPIADS_API_KEY 环境变量中填写;CLI 在执行命令的环境中设置同名变量。本页面不会要求你输入密钥。不要把密钥放进提示词或提交到代码仓库。

可以自动监控 TikTok 竞品吗?

持久化监控工具覆盖 Facebook 广告主及店铺或网站;TikTok 研究使用搜索与详情工具。MCP 本身不定时发起 AI 对话,如需周期报告,需要客户端或工作流提供调度能力。

图片搜索如何使用?

每次提交一个公开的 HTTP/HTTPS 图片链接或 Base64 图片,支持 JPEG、PNG、GIF、BMP、WebP,最大 10 MiB。使用返回的图片 ID 查询状态,等到 SEARCH_COMPLETED 后获取结果;遇到 ANALYSIS_FAILURE 或 SEARCH_FAILURE 时停止。

客户端里没有出现服务,怎么排查?

在终端运行 node --version 和 npx --version,确认 Node.js 不低于 20。检查 JSON 或 TOML 格式、密钥是否设置,以及客户端是否支持 stdio,并完全重启应用。如果找不到 npx,请改用本地安装的 npx 可执行文件绝对路径,并查看客户端 MCP 日志。

查询失败或没有结果,怎么办?

认证错误请检查 API Key;积分或权限错误请检查 API 控制台;空结果可以放宽时间、地区或关键词。默认超时为 30 秒,可通过 PIPIADS_TIMEOUT_MS 调整。服务不会自动重试,因为超时的付费查询或写操作可能已在上游执行。

下一个发现,从一个问题开始。

把 PipiAds 接入你每天使用的 AI 助手。

top-active

无法访问剪贴板,请选中下方文本手动复制。