AdMapix 广告创意数据
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/ad-creative-intel-free。
技能介绍
要解决什么问题
做广告创意研究、竞品素材盘点或应用市场情报时,团队往往要在 AdMapix 控制台里反复点筛选、翻页、导出,再把多类数据(创意列表、应用详情、商店排名、第三方下载/收入估算)拼进自己的分析流程。本技能不做自动研报、仪表盘或 H5 落地页,而是把 AdMapix 只读 API 当成可被 Agent 调用的数据源:单次请求返回与接口一致的 原始结构化 JSON,由对话里的 Agent 决定调哪些端点、如何串多次调用、如何做筛选与解读。
技能如何工作
实现上是 AdMapix Read API 的薄客户端。调用前会先检查 ADMAPIX_API_KEY(通过 X-API-Key 请求头,且不会在输出中泄露密钥);未配置时按用户语言展示注册与配置指引,不会在无 Key 时盲打 API。
创意与素材:POST /api/data/search 检索广告创意,配合 count、distribute、content-detail 等端点做数量与分布;创意检索 page_size 上限为 10,需用分页拉全量。首次使用某端点前应查阅技能附带的 reference(如 references/api-creative.md)以确认参数与响应字段。
元数据与筛选项:GET /api/data/filter-options 拉取国家、媒体渠道、广告类型、设备等合法编码;自然语言条件需对照 references/param-mappings.md 映射为创意类型、行业、日期区间等代码。
应用 / 产品 / 公司:统一产品搜索、应用详情、开发者信息、相似应用、某产品关联创意等,见 api-product.md 系列端点。
榜单与估算数据:应用商店免费/付费/畅销榜;下载与收入相关接口返回的是第三方估算,技能只做透传,呈现给用户时由 Agent 自行标注「非官方数据」。
输出规则强调:保留 API 字段名,不重命名、不摘要、不替你排序或写结论;空列表表示无匹配,不是错误。
边界与注意点
技能明确不在范围内:HTML/H5 页面生成、托管式「深度调研」、自主多步研究、摘要/洞察/推荐、发消息等。若平台提供 admapix.search_creatives 协议工具,创意搜索应优先使用该工具,否则直连 POST /api/data/search。HTTP 401 且 INVALID_API_KEY / NOT_AUTHENTICATED 时不应重试,应引导用户修正 Key 配置。
使用场景
- 投手要按国家、媒体渠道和创意类型筛一批竞品视频素材,并分页拉取原始字段做自有对比表
- 增长同学需要查某 unifiedProductId 的应用详情、相似应用及该包名下的关联广告创意数量
- 市场分析要在指定国家查看免费榜/畅销榜应用列表,并核对第三方下载、收入估算的明细接口返回值
- 运营在对话里用自然语言描述行业与时间范围,需先拉 filter-options 与 param-mappings 再构造合法 search 请求
适合人员
- 负责出海投放的优化师,希望在不离开 Agent 对话的情况下批量查询 AdMapix 创意与分布数据
- 做竞品应用追踪的产品经理,需要串应用搜索、开发者详情与商店排名等多接口原始结果
- 编写内部分析脚本的工程师,让 Agent 按端点目录组合调用并只处理返回的 JSON
- 为企业运营搭建情报工作流的数据同事,明确只要 API 透传、不要技能内自动生成摘要或仪表盘