> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/mcp/zh/exoclick-mcp-tools.md).
# 可用工具
一旦连接，你的 AI 助手就可以使用以下工具。你无需直接调用这些工具——只需用自然语言提出问题，AI 会自动使用合适的工具。
## 连接允许执行的内容
当你连接 AI 客户端时，你可以为每项能力选择一个访问级别：
| 级别 | 含义 |
|---|
| 读取 | AI 可以查看这些数据。 |
| 写入 | AI 可以查看这些数据并进行更改。 |
| 无访问权限 | AI 完全不能使用此能力。 |
这些设置只会缩小 AI 允许执行的操作范围。连接执行的操作永远不会超过你的账户本身已允许的范围。你的账户未拥有的能力，以及尚不可用的能力，不会显示。参见 [连接 AI 客户端](/mcp/zh/exoclick-mcp-connecting-ai-client.md) ，了解此处的设置位置。
## **统计**
查看你账户的性能数据，支持灵活过滤和分组。适用于广告主和发布商，且各自仅限于自己的数据范围。
**访问：** 读取
### 广告主统计
使用灵活的过滤和分组选项查询你的广告主统计数据。此工具可让你分析展示、点击、转化、收入、成本以及其他性能指标，并可按任意维度组合进行分析。
#### 你可以问什么
* 某个日期范围内的广告系列表现
* 按国家、设备、浏览器、操作系统、版位或其他任何可用维度进行拆分
* 按任意指标查看表现最佳或最差的项目
* 不同时间段之间的比较
* 筛选视图（例如：某个特定广告系列或版位的统计数据）
#### 示例提示
* *给我最近 7 天按花费排名最高的广告系列。*
* *本月我按国家划分的 eCPA 是多少？*
* *按设备类型分组，比较我本周和上周的展示次数。*
* *昨天哪些版位的 CR 最低？*
使用灵活的过滤和分组选项查询你的广告主统计数据。此工具可让你分析展示、点击、转化、成本以及其他性能指标，并可按任意维度组合进行分析。
### 发布商统计
使用灵活的过滤和分组选项查询你的发布商统计数据。此工具可让你分析展示、点击、eCPM 以及其他性能指标，并可按任意维度组合进行分析。
#### 你可以问什么
* 某个日期范围内的版位表现
* 按国家、设备、浏览器、操作系统、版位或其他任何可用维度进行拆分
* 按任意指标查看表现最佳或最差的项目
* 不同时间段之间的比较
* 筛选视图（例如：某个特定广告系列或版位的统计数据）
#### 示例提示
* *给我最近 7 天按收入排名最高的版位。*
* *本月我按国家划分的 eCPM 是多少？*
* *按设备类型分组，比较我本周和上周的展示次数。*
* *昨天我多格式中的哪些版位效果最好？*
## 广告系列
无需离开对话即可查看你的广告系列配置
这是一个 **仅广告主可用的** 工具。
**访问：** 读取或写入
### 查看
#### **你可以问什么**
* 按状态（运行中、已暂停）筛选或按名称搜索的广告系列列表
* 某个单一广告系列的完整配置（如果你请求的广告系列不存在或属于其他账户，工具会返回明确的“未找到”错误。）
* 你在某种状态下拥有多少个广告系列
* 某个国家中某种格式和类别的最低出价
* 你的账户可以使用哪些定向选项
广告系列列表会返回每个广告系列的 id、名称和状态。询问某个广告系列会返回其完整配置，包括：
| 区域 | 包含内容 |
| ------- | ---------------------------------------------------------------------------------- |
| 身份 | 名称、id、广告系列组、广告系列类型、创建日期。 |
| 广告格式 | 广告类型和标签、创意尺寸。 |
| 计价 | 计价模式（CPM、CPC 等）、价格、优化算法、关联出价方。 |
| 预算与投放 | 总预算和日预算上限、花费金额、展示限制、投放模式、频次控制。 |
| 排期 | 开始和结束日期、时区、按时段投放。 |
| 定向 | 国家和地区、语言、浏览器、操作系统、设备、运营商、ISP、类别、兴趣、关键词、IP 范围、站点、版位、RTB 库存以及重定向列表。每一项都会返回定向列表和屏蔽列表。 |
| 版位和网络规则 | 版位是定向还是屏蔽、合作伙伴网络设置、屏蔽标签和产品类别。 |
| 创意 | 每个变体及其落地页 URL、展示 URL、优惠、状态和审批状态，以及已批准、待处理、已拒绝和已暂停变体的汇总数量。 |
如果某个字段包含内部 id，响应还会同时提供可读名称，这样 AI 就能用自然语言回答，而不是原始 id。
#### **示例提示**
* *我有多少个活跃广告系列？*
* *显示我所有已暂停的广告系列。*
* *按名称排序，列出我第 5 组中的广告系列。*
* *我有任何定向到德国的广告系列吗？*
结果是分页返回的。对于拥有大量广告系列的账户，AI 会自动通过多次请求处理分页。
### 创建和更新
当该连接已被授予此能力的写入权限时可用。如果没有该权限，任何写入都会返回权限错误。在你重新连接并将 Campaigns 设置为 Write 之前，现有连接将保持只读。
#### **你可以问什么：**
* 创建一个广告系列，包括名称、广告类型、计价模式、出价、定向和创意
* 更新广告系列的设置和定向，包括日期范围和按时段投放
* 启用或暂停广告系列
* 添加或更新创意变体，并单独启用或暂停它们
* 复制一个广告系列，可选择重命名或切换其广告类型
* 向广告系列添加版位，或从中移除版位
LLM 仅提供你的账户可用的广告类型、类别、计价模式和定向选项。
#### **示例提示：**
* *创建一个名为 Summer Sale 的 CPM 横幅广告系列，定向西班牙，出价 0.50。*
* *向广告系列 X 添加一个 300x250 变体，指向 example.com。*
* *将广告系列 X 的出价提高到 0.80。*
* *暂停广告系列 X 的变体。*
* *复制广告系列 X，改为定向版位。*
* 定向版位 X 和/或屏蔽版位 X
每项更改在应用前都会先汇总，因此在你确认之前不会写入任何内容。
#### **预期内容**
| 情况 | 行为 |
| ------- | ------------------------------------------------------------ |
| 新广告系列 | 默认创建为暂停状态，除非你要求立即上线。 |
| 复制的广告系列 | 保留原广告系列的状态。 |
| 创意 | 使用你媒体库中已有的素材，可通过 id 或名称引用。如果某个名称匹配多个素材，会要求你确认具体项，且不会更改任何内容。 |
| 出价和预算 | 以你账户的货币设置。低于该国家和格式最低价格的出价会被拒绝。 |
| 你不可用的格式 | 保留给管理员的广告类型和设置，或在你的网络中被禁用的内容，不能使用。 |
| 尚不支持 | 上传素材、Smart Bid 和 Dynamic CPA 广告系列、归档、行为重定向、兴趣定向以及网络特定的自定义定向。 |
## 站点和版位
以对话方式探索你的站点和广告版位，列出、筛选和搜索它们，并深入查看任意单个站点或版位的设置，包括版位屏蔽的标签和产品类别。
这是一个 **仅发布商可用的** 工具。
**访问：** 读取或写入
### 查看
* 按状态、站点类型或广告类型筛选，或按名称搜索的站点或版位列表
* 属于某个特定站点的版位
* 某个单一站点或版位的完整配置
* 你的哪些版位是活跃的
**询问站点会返回：**
| 区域 | 包含内容 |
| -- | ---------------- |
| 身份 | 名称、id、URL、描述。 |
| 分类 | 站点类型（网站、应用等）、类别。 |
| 状态 | 活跃状态和审批状态。 |
**询问版位会返回更完整的配置，包括：**
| 区域 | 包含内容 |
| ---- | -------------------------------------------------- |
| 身份 | 名称、id、父站点 id 和名称。 |
| 格式 | 发布商广告类型和标签、尺寸、版位是否响应式，以及对于多格式版位，子版位及其布局。 |
| 计价 | 最低 CPM、底价类型（软底价或硬底价）、计价模式。 |
| 投放控制 | 频次控制、展示上限、广告刷新率、浏览器限制、兜底广告。 |
| 外观 | 粘性位置、边框和颜色、文本颜色、字体、缩略图设置。 |
| 视频 | 前贴片、中贴片和后贴片设置、VAST 配置、VAST 包装支持、VMAP、CTA 覆盖层、跳过时间。 |
| 弹窗设置 | 触发方式、触发类、延迟、兜底、新标签页行为。 |
| 屏蔽 | 发布商屏蔽的标签、被屏蔽的产品类别、合规规则。 |
| 类别 | 主类别和子类别。 |
| 标志 | 活跃状态、库存跟踪、认证级别、出价分层、BURL、广告透明度对话框。 |
如果某个字段包含内部 id，响应还会同时提供可读名称，这样 AI 就能用自然语言回答，而不是原始 id。
结果采用分页返回，因此大型账户会分批返回，而不是一次性全部返回。
#### **示例提示**
* *我的哪些版位是活跃的？*
* *站点 X 的设置是什么？*
* *列出我站点 X 上的所有版位。*
* *我的哪些版位设置了 CPM 底价？*
* *显示版位 X 上屏蔽的标签。*
* *列出我仍在等待审批的站点。*
### **创建和更新**
当该连接已被授予此能力的写入权限时可用。如果没有该权限，任何写入都会返回权限错误。在引入访问级别之前已授权的连接将保持只读，直到你重新连接。
#### **你可以问什么：**
* 创建站点
* 创建任何受支持广告类型的版位，包括 RTB、原生组件、视频内 VAST、网页推送、页面内推送和多格式
* 更新站点的名称、描述或类别
* 更新版位的设置，或将其移动到其他站点
#### **示例提示：**
* *在 Entertainment 类别下为 example.com 创建一个新站点。*
* *向我的站点 X 添加一个 300x250 横幅版位。*
* *将版位 1234567 重命名为 Homepage Top。*
* *将版位 1234567 移动到我的另一个站点。*
每项更改在应用前都会先汇总，因此在你确认之前不会写入任何内容。
#### **预期内容**
| 情况 | 行为 |
| ----------- | ----------------------------- |
| 新站点 | 可能会以未验证状态返回，此时验证会在管理面板中完成。 |
| 更改站点类别 | 会将站点恢复为待审批状态。 |
| 站点的 URL 和类型 | 在创建时设置，之后不能更改。 |
| 版位的广告类型 | 在创建时设置，之后不能更改。 |
| 横幅和移动端横幅版位 | 需要尺寸。 |
| RTB 版位 | 需要广告交易平台合作伙伴，并且不需要尺寸。 |
| 你不可用的格式 | 保留给管理员的格式，或在你的网络中被禁用的格式，不能创建。 |
## **参考：按能力划分的工具**
如果你的 AI 客户端显示的是原始工具名称，这就是完整列表。
| 工具 | 能力 | 访问权限 |
| ----------------------------------- | ------- | ---- |
| get\_advertiser\_global\_statistics | 统计（广告主） | 读取 |
| get\_publisher\_global\_statistics | 统计（发布商） | 读取 |
| get\_campaigns | 广告系列 | 读取 |
| get\_campaign | 广告系列 | 读取 |
| get\_campaign\_groups | 广告系列 | 读取 |
| get\_zone\_targeting\_options | 广告系列 | 读取 |
| get\_minimum\_prices | 广告系列 | 读取 |
| create\_campaign | 广告系列 | 写入 |
| update\_campaign | 广告系列 | 写入 |
| copy\_campaign | 广告系列 | 写入 |
| add\_campaign\_variation | 广告系列 | 写入 |
| play\_campaign\_variations | 广告系列 | 写入 |
| pause\_campaign\_variations | 广告系列 | 写入 |
| add\_campaign\_zones | 广告系列 | 写入 |
| remove\_campaign\_zones | 广告系列 | 写入 |
| get\_sites | 站点和版位 | 读取 |
| get\_site | 站点和版位 | 读取 |
| get\_zones | 站点和版位 | 读取 |
| get\_zone | 站点和版位 | 读取 |
| create\_site | 站点和版位 | 写入 |
| update\_site | 站点和版位 | 写入 |
| create\_zone | 站点和版位 | 写入 |
| update\_zone | 站点和版位 | 写入 |
| get\_collection | 支持项 | 始终可用 |
## 公开技能库
除了 MCP Server 之外，ExoClick 还可以访问一个 [**预构建技能的公开仓库**](https://github.com/EXADS/ai-skills)，其中包含针对常见广告任务设计的优化提示和工作流。这些技能通过经过验证的方法，为你在日常效果分析、广告系列优化审查和报告等任务上提供一个良好的起点。
| 技能 | 作用 |
| --------------------------- | -------------------------------------- |
| daily-top-campaigns | 展示你某一天表现最佳的广告主广告系列。 |
| statistics-analysis | 分析某个日期范围内的广告主表现，并将其与之前的时间窗口进行比较。 |
| fetch-advertiser-statistics | 按任意受支持维度获取广告主统计数据，可单独使用，也可作为其他技能的构建模块。 |
| fetch-publisher-statistics | 按任意受支持维度获取发布商统计数据。 |
技能完全可选。MCP Server 可与你自己编写的任何提示或问题配合使用。技能库只是为了帮助你更快上手，并受益于 ExoClick 团队经过测试和优化的工作流。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.exoclick.com/mcp/zh/exoclick-mcp-tools.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.