القائمة
查询 DataEye AdXray 广告透视平台数据，包括产品投放趋势、媒体分布、热门排行、新品排行、搜索产品等
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Discord 社区数据查询：频道消息、成员列表、线程
Figma 设计文件查询：读取文件结构、导出界面截图、查看组件和样式
GitLab 代码仓库数据查询：提交记录、Merge Request、项目成员、用户活跃度
生成交互式 HTML 可视化（图表、流程图、UI原型、数据仪表盘、演示页等）
将自己的 Skill 分享给同事或部门，管理已分享的 Skill
浏览、搜索、安装、卸载所有 Skill（系统/共享/个人）
| name | ADX广告数据查询 |
| description | 查询 DataEye AdXray 广告透视平台数据，包括产品投放趋势、媒体分布、热门排行、新品排行、搜索产品等 |
| triggers | ["ADX","AdXray","DataEye","广告透视","投放素材","媒体分布","热门排行","竞品分析","广告情报","设置ADX","设置ADX凭证","ADX账号"] |
| tool | tools/adx_query.py |
| default | false |
| credentials | {"key":"adx","display_name":"ADX (DataEye)","setup":"manual","fields":[{"name":"email","label":"AdXray 登录邮箱"},{"name":"password","label":"登录密码","secret":true}]} |
通过 DataEye AdXray 平台 API 查询手游广告情报数据，包括产品信息、投放趋势、媒体分布、排行榜等。
本文件位于
skills/adx-query/，下文中的相对路径均基于项目根目录。
pip install requests ddddocr
ddddocr 用于自动识别登录验证码（简单 4 位字母数字），识别失败会自动重试最多 5 次。
使用前需先设置 ADX 凭证（DataEye AdXray 平台的登录邮箱和密码）：
python3 tools/adx_query.py setup --email "user@tuyoogame.com" --password "your-password"
清除凭证：
python3 tools/adx_query.py clear-credentials
凭证通过环境变量 _TYCLAW_ADX_EMAIL / _TYCLAW_ADX_PASSWORD 自动注入，也可通过 --email / --password 命令行参数手动传入（优先级高于环境变量）。
当用户说「设置ADX凭证」「ADX账号」时，询问用户提供 DataEye AdXray 平台的登录邮箱和密码，然后调用 setup。
tools/adx_query.py（从 TyClaw 项目根目录运行）
脚本自动处理验证码识别、登录、session 缓存和 API 签名。
# 搜索产品（凭证已通过 setup 预配置）
python3 tools/adx_query.py search --keyword "次神"
# 查询产品基本信息
python3 tools/adx_query.py product_info --product-id 36528
# 查询投放趋势（最近 7 天）
python3 tools/adx_query.py trend --product-id 36528 --days 7
# 查询投放趋势（指定日期范围）
python3 tools/adx_query.py trend --product-id 36528 --start-date 2026-03-01 --end-date 2026-03-20
# 查询媒体分布
python3 tools/adx_query.py media_dist --product-id 36528 --days 7
# 热门产品排行
python3 tools/adx_query.py hot_ranking --days 7 --page 1 --size 20
# 新品排行
python3 tools/adx_query.py new_ranking --days 7
# 手动传入凭证（覆盖环境变量）
python3 tools/adx_query.py --email user@example.com --password pass123 search --keyword "次神"
| 参数 | 说明 | 必须 |
|---|---|---|
--email | AdXray 账号邮箱 | 可选，优先于环境变量 |
--password | 账号密码 | 可选，优先于环境变量 |
子命令：
| 子命令 | 说明 | 关键参数 |
|---|---|---|
search | 搜索产品/媒体/发行商 | --keyword |
product_info | 产品基本信息 | --product-id |
trend | 投放趋势（素材数/计划数） | --product-id, --days 或 --start-date/--end-date |
media_dist | 媒体分布 | --product-id, --days |
hot_ranking | 热门产品排行 | --days, --page, --size |
new_ranking | 新品排行 | --days, --page, --size |
| 端点 | 说明 | 关键参数 |
|---|---|---|
/product/getProductInfo | 产品详情（名称、公司、素材数、排名） | productId |
/product/listTrendByProduct | 投放趋势（素材数/计划数按天） | productId, startDate, endDate |
/product/listMediaDistributionV2 | 媒体分布 | productId, startDate, endDate |
/product/listPositionDistributionV2 | 广告位分布 | productId, startDate, endDate |
/product/audienceAnalysis | 受众分析 | productId, productName |
/product/getProductVideo | 视频素材 | productId |
排行榜接口使用 pageId（非 pageNo），需要 searchType=1, top=500, adForm=INFO_FLOW。
| 端点 | 说明 |
|---|---|
/product/listHotProductRanking | 热门产品排行 |
/product/listNewProductRanking | 新品排行 |
/product/listTopNewProduct | Top 新品（简洁列表） |
| 端点 | 说明 | 关键参数 |
|---|---|---|
/search/quickSearch | 搜索产品/媒体/发行商 | searchKey, top, isHighLight |
搜索结果字段为 id 和 name，id 可作为产品端点的 productId 使用。
GET /user/getVerifyCode → PNG 验证码图片（80×30，4 位字母数字）POST /user/login：accountId（邮箱）+ password（MD5）+ vCode（验证码）App.userKey 作为后续请求的 token~/.cache/adxray_session.json，1 小时内免重复登录每个数据请求需要 sign 和 token 参数：
key1=value1&key2=value2&...&key=g:%w0k7&q1v9^tRnLz!Msigntoken = 登录后获取的 App.userKeyPOST 请求需要请求头 s: MD5(今日日期 "YYYY/M/D")，以及 thisTimes: int(time()*1000/100) 参数。