README_CN.md

# AdMapix — 广告情报与应用分析 Skill

[English](README.md)

一站式广告情报助手。通过自然语言搜索广告素材、分析应用、查看排行榜、追踪下载量/收入、获取市场洞察。

## 功能

- **素材搜索** — 按关键词、地区、媒体、素材类型搜索广告创意，支持 H5 可视化结果
- **应用分析** — 查询任意应用的详情、开发者信息、广告素材库
- **排行榜** — App Store / Google Play 官方榜单，推广排行、下载排行、收入排行
- **下载量与收入** — 追踪下载量和收入的时间趋势（第三方估算数据）
- **投放分布** — 分析应用在哪些国家、哪些媒体位、用什么素材类型投放广告
- **市场分析** — 按国家、媒体渠道、广告主、流量主维度的行业级洞察
- **深度分析** — 多维度综合报告，整合以上所有能力
- **深度研究** — AI 驱动的深度分析，适用于复杂查询（多应用对比、市场策略报告、趋势分析）。需要 2 个以上 API 调用的问题会自动触发，返回结构化 HTML 报告和核心发现

## 安装

```bash
npx clawhub install admapix
```

## 配置

1. 前往 [www.admapix.com](https://www.admapix.com) 注册并获取 API Key
2. 选择一种方式配置：

OpenClaw / ClawHub：

```bash
openclaw config set skills.entries.admapix.apiKey "<你的-key>"
```

通用环境变量：

```bash
export ADMAPIX_API_KEY="<你的-key>"
```

## 使用示例

安装配置完成后，直接对 AI 助手说：

| 分类 | 示例指令 |
|------|----------|
| 素材搜索 | 「搜一下 puzzle game 的视频广告」「找东南亚投放的休闲游戏素材」 |
| 应用分析 | 「分析一下 Temu」「TikTok 的开发者是谁？」 |
| 排行榜 | 「美国 App Store 免费榜」「这周广告投放量最大的 App」 |
| 下载量 | 「Temu 最近下载量怎么样？」「对比 Temu 和 SHEIN 的下载量」 |
| 投放分布 | 「Temu 主要在哪些国家投广告？」「这个游戏用了哪些广告渠道？」 |
| 市场分析 | 「全球游戏广告市场哪个国家最大？」「谁是最大的游戏广告主？」 |
| 深度分析 | 「全面分析 Temu 的广告策略」「对比 Temu 和 SHEIN」 |
| 深度研究 | 「分析 Temu 在东南亚的广告策略」「对比 Top 5 休闲游戏的广告表现」 |

支持 **中文** 和 **英文** 双语 — 助手会自动匹配你的语言。

## 深度研究 — AI 驱动的智能分析报告

面对复杂的分析需求，AdMapix 会自动激活 **深度研究引擎** — 一个服务端 AI 研究系统，远超简单的 API 查询。

**工作原理：**

1. Skill 自动评估问题复杂度。简单查询（单次搜索、单个排行）直接处理；涉及跨维度分析的问题自动路由到深度研究引擎。
2. 研究引擎自主规划并执行多步调研 — 协调数十个 API 调用、交叉验证多个数据源、综合分析并提炼洞察。
3. 最终输出结构化 HTML 报告，附带核心发现摘要，可直接分享或用于进一步决策。

**什么情况会触发深度研究：**

- 多应用对比：*「对比 Temu、SHEIN 和 Wish 的广告策略」*
- 策略分析：*「这款游戏在日本是怎么做用户获取的？」*
- 市场情报：*「东南亚休闲游戏广告市场概况」*
- 趋势解读：*「这个 App 上周下载量为什么暴涨？」*
- 任何需要 2 个以上 API 调用或跨实体推理的问题

**你会得到：**

- 带图表和数据表格的结构化 HTML 报告
- 核心发现的高管摘要
- 跨维度洞察（地域 × 媒体 × 素材 × 时间）
- 基于竞品数据的可执行建议

研究引擎通常在 1-5 分钟内完成，取决于查询复杂度。报告在线托管，支持链接分享。

## 链接

- 官网：[www.admapix.com](https://www.admapix.com)
- GitHub：[github.com/fly0pants/admapix](https://github.com/fly0pants/admapix)

---

由 [妙智盛](https://www.admapix.com) 提供技术支持