X Ads MCP by InsightfulPipe

Insightful Pipe 的 X Ads MCP 服务（Twitter Ads）

将 X Ads（前身为 Twitter Ads）接入 AI 助手，用于报告和创建广告系列、广告组、仅推广帖子和卡片；新建广告系列默认暂停。

该服务属于 Insightful Pipe MCP 服务集合——X Ads MCP 服务为 Claude、ChatGPT、Cursor 等 AI 助手提供 80 项操作（52 项读取操作和 28 项更改操作），可用于管理你的 X 广告账户。助手可以报告广告系列、广告组、推广帖子和创意素材的情况，随后创建广告系列、广告组、仅推广的广告帖子，以及网站、应用或轮播卡片。新建的广告系列和广告组默认暂停；广告帖子创建为仅推广内容，因此不会出现在你的公开时间线上；删除操作默认关闭，只有管理员启用后才能使用。

如需管理账户自己的帖子、回复、私信和帖子分析数据，请使用 X Organic MCP 服务。

MCP 服务 URL

https://x-ads.insightfulmcp.com/

什么是 X Ads MCP？

X Ads MCP 是一个远程模型上下文协议服务，可将你的 X Ads Manager 连接到 AI 助手。通过此实时广告集成，你可以：

• 使用自然语言查询 X 广告表现
• 分析推广推文的互动情况
• 跟踪视频观看量和网站转化
• 为大型数据集创建异步分析任务
• 获取用于优化广告系列的 AI 建议

安装

Claude

1. 复制 MCP 服务 URL：https://x-ads.insightfulmcp.com/
2. 打开 Claude 连接器设置（自定义 > 连接器），点击 +，然后点击 添加自定义连接器
3. 粘贴 URL 并点击 添加
4. 点击 连接，并在提示时登录 InsightfulPipe。随后，Claude 会将该连接器列为已连接。

ChatGPT

请通过 ChatGPT 的开发者模式添加自定义 MCP 服务。是否可用取决于你的 ChatGPT 套餐；工作区管理员可能还需要启用该功能。

1. 在 ChatGPT 设置中开启开发者模式
2. 为远程 MCP 服务创建一个新应用，并粘贴 URL：https://x-ads.insightfulmcp.com/
3. 如有提示，请登录 InsightfulPipe。登录后即完成连接。

请参阅 OpenAI 指南：ChatGPT 中的开发者模式和 MCP 应用

Claude Code

claude mcp add --transport http x-ads https://x-ads.insightfulmcp.com/

Cursor

将服务添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（适用于单个项目）：

{
  "mcpServers": {
    "x-ads": {
      "url": "https://x-ads.insightfulmcp.com/"
    }
  }
}

当 Cursor 显示需要身份验证时，点击连接，并在提示时登录 InsightfulPipe。

可用操作

共 80 项操作：52 项读取操作和 28 项更改操作，其中 11 项具有破坏性，默认关闭。

读取操作（52 项）

显示全部 52 项读取操作

| 操作 | 描述 | |--------|-------------| | `create_async_job` | 创建异步分析任务 | | `get_account` | 获取特定广告账户的详细信息 | | `get_account_history` | 获取账户中特定实体变更情况的摘要 | | `get_account_media` | 列出与当前账户关联的媒体素材 | | `get_account_media_item` | 获取特定账户媒体对象的详细信息 | | `get_active_entities` | 获取指定时间范围内有活动的实体（广告系列、广告组等） | | `get_advertiser_business_categories` | 获取广告组可用的广告主业务类别 | | `get_async_jobs` | 获取异步分析任务的详细信息 | | `get_authenticated_user_access` | 获取经过身份验证的用户在当前账户中的权限 | | `get_campaign` | 获取特定广告系列的详细信息 | | `get_campaigns` | 列出广告账户的所有广告系列 | | `get_card` | 获取特定卡片的详细信息 | | `get_cards` | 列出与当前账户关联的卡片 | | `get_content_categories` | 获取开屏视频定向的内容类别 | | `get_features` | 获取当前账户已启用的功能 | | `get_funding_instrument` | 获取特定资金工具的详细信息 | | `get_funding_instruments` | 列出广告账户的所有资金工具 | | `get_iab_categories` | 获取 IAB 内容类别 | | `get_line_item` | 获取特定广告组的详细信息 | | `get_line_items` | 列出广告账户的所有广告组 | | `get_media_creative` | 获取特定媒体创意的详细信息 | | `get_media_creatives` | 列出广告账户的所有媒体创意 | | `get_media_library` | 列出与当前账户关联的媒体库对象 | | `get_media_library_item` | 获取特定媒体库对象的详细信息 | | `get_promotable_user` | 获取特定可推广用户的详细信息 | | `get_promotable_users` | 列出与当前账户关联的可推广用户 | | `get_promoted_account` | 获取特定推广账户的详细信息 | | `get_promoted_accounts` | 列出与当前账户下广告组关联的推广账户 | | `get_promoted_tweet` | 获取特定推广推文的详细信息 | | `get_promoted_tweets` | 列出与当前账户下广告组关联的推广推文 | | `get_recommendations` | 获取账户的广告系列优化建议 | | `get_scheduled_promoted_tweet` | 获取特定已排期推广推文的详细信息 | | `get_scheduled_promoted_tweets` | 列出与当前账户关联的已排期推广推文 | | `get_stats` | 获取广告账户的同步分析数据 | | `get_targeting_app_store_categories` | 查找可用的基于应用商店类别的定向条件 | | `get_targeting_conversations` | 查找可用的基于对话的定向条件 | | `get_targeting_criteria` | 列出与当前账户下广告组关联的定向条件 | | `get_targeting_criterion` | 获取特定定向条件的详细信息 | | `get_targeting_devices` | 查找可用的基于设备的定向条件 | | `get_targeting_events` | 查找可用的基于事件的定向条件 | | `get_targeting_interests` | 查找可用的基于兴趣的定向条件 | | `get_targeting_languages` | 查找可用的语言定向条件 | | `get_targeting_locations` | 查找可用的基于位置的定向条件（国家、地区、城市、邮政编码、都会区） | | `get_targeting_network_operators` | 查找可用的网络运营商（电信运营商）定向条件 | | `get_targeting_platform_versions` | 查找可用的基于移动操作系统版本的定向条件 | | `get_targeting_platforms` | 查找可用的基于平台的定向条件（iOS、Android 等） | | `get_targeting_suggestions` | 获取关键词或用户定向建议，以补充您的定向选择 | | `get_targeting_tv_markets` | 查找可定向电视节目的可用电视市场 | | `get_targeting_tv_shows` | 查找可用的基于电视节目的定向条件 | | `get_tax_settings` | 获取当前账户的税务设置详细信息 | | `get_tracking_tag` | 获取特定跟踪标签的详细信息 | | `get_tracking_tags` | 列出与当前账户关联的跟踪标签 |

可执行更改的操作（28 项）

显示全部 28 项写入和破坏性操作

操作	描述
cancel_async_job	取消正在处理的异步分析任务
create_ad_tweet	创建仅用于推广的（nullcast）推文，以用于广告活动
create_campaign	创建新的广告活动（为安全起见，创建时状态为 PAUSED）
create_card	创建用于推文的卡片（网站、应用或轮播）
create_line_item	在广告活动下创建新的广告组（为安全起见，创建时状态为 PAUSED）
create_media_creative	创建媒体创意素材并将其关联到广告组
create_media_library_item	将媒体素材添加到账户媒体库
create_promoted_account	将用户账户关联到广告组，作为推广账户
create_promoted_tweet	将推文关联到广告组，作为推广推文
create_scheduled_promoted_tweet	将定时推文关联到广告组，作为定时推广推文
create_scheduled_tweet	创建定时推文，以便日后发布
create_targeting_criterion	为广告组创建定向条件
create_tracking_tag	为广告组创建跟踪标签
delete_campaign	删除广告活动
delete_card	删除卡片
delete_line_item	删除广告组
delete_media_creative	删除媒体创意素材
delete_promoted_account	移除推广账户关联
delete_promoted_tweet	移除推广推文关联
delete_scheduled_promoted_tweet	移除定时推广推文关联
delete_scheduled_tweet	删除定时推文
delete_targeting_criterion	删除定向条件
delete_tracking_tag	删除跟踪标签
update_campaign	更新现有广告活动
update_line_item	更新现有广告组
update_media_library_item	更新媒体库对象的元数据
update_tracking_tag	更新现有跟踪标签
upload_media	上传用于广告的图片

控制 AI 的操作权限

你可以决定 AI Agent 在每个已连接账户中可以执行哪些操作：

• 为每个已连接账户单独启用或关闭操作，让 Agent 只能看到你允许的操作。
• 以只读或读写模式连接。 只读连接只能启用读取操作。
• 破坏性操作默认关闭。 删除等操作会保持禁用状态，直至管理员启用。
• 按账户授予团队访问权限。 受限团队成员只能使用获准访问的账户，以及这些账户上已启用的读取操作。

使用示例

广告活动效果

"How are my X ad campaigns performing this week?"

推文分析

"Which promoted tweets have the highest engagement rate?"

广告组效果

"Show me stats for my top performing line items"

异步报告

"Create an async analytics job for the last 90 days"

创意素材效果

"What creatives are driving the most conversions?"

支持的指标

指标	描述
展示量	推文总浏览量
互动量	点赞、转推、回复、点击
互动率	互动量 / 展示量
链接点击量	指向你网站的点击次数
视频观看量	视频广告观看次数
关注数	新增关注者数量
应用安装量	移动应用安装次数
单次互动成本	平均 CPE

为什么选择 X Ads MCP？

面向品牌营销人员

• 实时互动 - 跟踪推广帖子的互动情况
• 热门话题 - 借势趋势热点
• 品牌知名度 - 衡量覆盖面和互动情况

面向效果营销人员

• 转化跟踪 - 跟踪网站和应用操作
• 异步分析 - 处理较大的数据范围
• 广告组优化 - 获取细粒度效果数据

面向代理商

• 多账户管理 - 管理客户账户组合
• 自动生成报告 - 生成互动报告

安全与隐私

• X Developer Platform - 官方 API 访问
• OAuth 2.0 - 安全的 X 身份验证
• 数据加密 - 安全传输

定价

X Ads MCP 服务包含在每个 InsightfulPipe 套餐中，同时还包含所有其他 MCP 服务和 CLI。套餐起价为每月 $29.99，你可以免费试用 7 天。请访问 insightfulpipe.com/pricing 查看当前套餐。

即用型技能和提示词

• 适用于社交媒体广告的 Claude 技能 — 可在已连接的数据上运行的即用型技能

探索更多 Insightful Pipe MCP 服务

访问 insightfulpipe.com/mcp-servers，了解我们为营销和分析打造的完整 MCP 服务集合。

社交广告 MCP 服务

• Facebook Ads MCP - 社交广告
• TikTok Ads MCP - 视频广告
• LinkedIn Ads MCP - 职业社交平台
• Snapchat Ads MCP - 面向 Z 世代的广告

搜索广告 MCP 服务

• Google Ads MCP - 搜索广告
• Microsoft Ads MCP - Bing 广告

查看所有 MCP 服务 →

资源

• 文档
• 视频教程
• InsightfulPipe 博客

支持

• 文档：insightfulpipe.com/docs
• 所有 MCP 服务：insightfulpipe.com/mcp-servers
• 电子邮件：[email protected]

---

Insightful Pipe — 通过 MCP 服务实现 AI 驱动的营销分析。探索所有集成 →

许可证

MIT 许可证 - 详情请参阅 LICENSE。