SuperAPI AI 工具集

admapix

营销与增长

查看项目

更新于 10-16 05:47

技能介绍

用途:从 AdMapix 获取竞品广告创意原始数据,适用于搜广告、找素材、广告视频、创意素材、竞品广告、ad spy 等场景。仅返回结构化数据,不做展示、消息发送、自主研究、总结、洞察、推荐或仪表盘工作流。

主要能力:优先使用 admapix.search_creatives MCP 工具;无 MCP 时直接调用 API:curl -s -X POST "https://api.admapix.com/api/data/search" -H "X-API-Key: $ADMAPIX_API_KEY" -H "Content-Type: application/json" -d '{"content_type":"creative","keyword":"puzzle game","page":1,"page_size":20,"sort_field":"3","sort_rule":"desc"}'。切勿打印或暴露 API 密钥。

请求参数:keyword(应用名、广告文案、广告主、产品或品类);creative_team(创意类型代码,如 ["010"] 表示视频);country_ids(国家代码,如 ["US","JP"]);start_date、end_date(YYYY-MM-DD);sort_field("3" 首次出现、"4" 活跃天数、"11" 相关性、"15" 展示量);sort_rule(desc/asc);page(从 1 开始);page_size(1-60);trade_level1(行业分类 ID);content_type 固定为 "creative"。不要添加展示生成或消息发送字段。

参数解析:提取用户提供的所有参数;自然语言映射(视频/图片/试玩、东南亚/美国/日韩/欧洲、最近一周/上个月、最新/展示最多/投放最久、分页)可参考 references/param-mappings.md。若用户未提供关键词或等价可搜索目标,需简洁追问一次关键词,其余参数可用默认值。

输出规则:仅返回原始结构化 JSON,尽量保留 API 字段名。成功响应形如 {"request":{...},"totalSize":1234,"page":1,"page_size":20,"list":[]};错误返回 {"error":{"code":"missing_api_key","message":"Missing ADMAPIX_API_KEY environment variable","retry":false}}。不得将记录隐藏在外部展示链接后,不得总结结果列表,不得排名、分析或推荐策略(除非用户收到数据后另行要求分析),不得运行多步自主工作流或外部搜索,不得格式化为落地页、卡片、表格优先文档或仪表盘。

原始字段:list 中每项可能包含 id、title、describe、imageUrl、videoUrl、playHtmlUrl、globalFirstTime、globalLastTime、findCntSum、impression、showCnt、adSource、appList(含 name、pkg、logo)等。

限制:需配置 ADMAPIX_API_KEY;仅做原始数据检索,不提供分析或展示;具体收费、价格、平台支持范围等资料暂未提供。