AdMapix

核心用法

AdMapix 是一个纯文档型数据层 Skill，作为 AdMapix API 的轻量级客户端。它不执行分析或生成页面，而是将原始结构化数据以 JSON 格式返回，由调用方（如 Claude Code、Codex）自行编排多调用工作流并进行分析。

主要功能模块：

1. 广告素材搜索 (/api/data/search) — 搜索广告创意，支持按国家、行业、广告类型、设备等维度筛选
2. 应用/产品数据 (/api/data/product-search, /api/data/app-detail) — 获取应用详情、开发者信息、相似应用推荐
3. 排行榜数据 (/api/data/store-rank) — App Store 免费榜、付费榜、畅销榜排名
4. 下载量与收入估算 (/api/data/download-*, /api/data/revenue-*) — 第三方估算数据（需注明为估算值）
5. 市场分析 (/api/data/market-search) — 市场级聚合搜索与分布分析

使用流程：

• 验证 ADMAPIX_API_KEY 环境变量 → 读取参数映射文档 → 调用对应端点 → 返回原始 JSON
• 创意搜索 page_size 上限为 10，超出需分页
• 所有请求通过 HTTPS 发送至 api.admapix.com，API Key 通过 X-API-Key Header 传入

显著优点

• 纯文档零代码执行：99.8% 为 Markdown，无危险函数、无敏感信息硬编码
• 数据覆盖全面：涵盖广告素材、应用数据、排行榜、收入估算等移动营销全链路数据
• 安全架构优秀：API Key 通过环境变量读取，密钥不落地、不打印、不存储
• 双语支持完整：中英文配置指南，自动检测用户语言
• 合规性良好：通过 GDPR 数据最小化、CCPA 用户知情权、HTTPS 加密等 6 项合规检测

潜在局限

• 纯数据层无分析能力：不自动生成洞察、排名或可视化，需用户自行编排分析流程
• 第三方估算数据：下载量/收入数据为第三方估算，非官方数据，需明确标注
• API Key 依赖：功能完全依赖外部 API，无 Key 时无法使用任何功能
• 无缓存机制：每次调用均实时请求 API，无本地数据缓存
• 分页限制严格：创意搜索单次最多返回 10 条，大数据量查询需多次分页

适合人群

• 移动营销从业者：需要追踪竞品广告素材、分析投放策略
• 产品经理/分析师：需要获取应用排行榜、下载趋势、收入估算数据
• 市场研究人员：需要批量获取广告创意进行行业分析
• 开发者/数据工程师：需要结构化原始数据集成到自有分析 pipeline

常规风险

• API Key 泄露风险：虽环境变量读取安全，但用户配置不当可能导致 Key 暴露
• API 服务可用性依赖：功能完全依赖 AdMapix 官方服务，存在单点故障风险
• 数据时效性：返回数据为 API 快照，非实时数据，分析时需注明数据时间点
• 估算数据误用：下载量/收入为第三方估算，若作为财务决策依据存在偏差风险