让你的 AI 成为广告分析师
Invx 开放 API 已上线：把你的 OpenClaw 小龙虾、Coze 扣子、Dify、Hermes 等国产 AI 客户端接入 Invx， 用自然语言查询广告与商品数据、分析投放趋势与利润、真实启停广告组。 无需自建 AI 平台，不买昂贵的 AI 调优服务，用你自己的 AI 就够了。
想用 AI 直接调数据？复制下面这段话，发给你的 AI 客户端 （OpenClaw 小龙虾 / Dify / Coze 等），它会自动通过SkillHub 技能商店安装 Invx 官方 Skill，无需手动配置。
请先安装 SkillHub 技能商店 CLI（安装说明：https://skillhub.cn/install/skillhub.md），然后执行命令 skillhub install invx-ads-skill --dir <你的 AI 客户端 skills 目录>，安装 Invx 官方 Skill「invx-ads-skill」。这个 Skill 内置了 Invx 跨境电商广告平台的 22 个开放 API 定义，能帮我查询广告投放数据（按投放日真实指标 / 概览 / 趋势 / 渠道对比）、店铺商品信息（正标题 / 副标题 / 主副图 / 详情 / 定价 / 库存）、库存预警与补货建议、SKU 利润、Amazon 归因报表，还可以真实启停广告组（同步下发渠道后台）。安装后请配置环境变量 INVX_API_KEY（格式为 invx_pk_ 开头的字符串），后续我会直接让你用自然语言查询和分析这些数据。
三步接入你的 AI
全程 5 分钟，无需安装任何本地插件
注册并生成 API Key
注册 Invx 账号，在「设置 → API Key」中为团队成员创建 Key，明文仅展示一次。
1 分钟接入你的 AI 工具
把 API Key 与接口地址配置进 OpenClaw 小龙虾、Coze 扣子、Dify、Hermes 等任意支持自定义 API 的国产 AI 客户端。
3 分钟开始用自然语言调数据
直接问「近 7 天哪个渠道 ROI 最高」「暂停 ROI 低于 1.5 的广告组」，AI 实时返回结果。
即刻生效AI 能帮你做什么
覆盖数据查询、分析与投放调优的完整链路
投放数据查询
按投放日真实指标（消耗 / 曝光 / 点击 / 转化 / ROAS）+ 概览与趋势
商品信息读取
店铺商品正标题 / 副标题 / 主副图 / 详情 / 定价 / 库存（Amazon SP-API 与 Shopee 同步）
库存与补货预警
库存状态、补货建议、断货预测、缺货自动暂停记录一网打尽
利润与归因分析
SKU 净利 / 利润率、Amazon Attribution 归因标签与日报
广告组真实启停
自然语言启停广告组，默认同步下发渠道后台（Google / TikTok / Amazon）
权限实时继承
Key 权限随成员角色实时生效；积分余额、素材库、调用配额随时查
两种接入方式，任选其一
REST API 是核心，Function Calling 让 AI 原生调用
# 按投放日查询最近 7 天各渠道真实指标（推荐口径）
curl "https://invx.cn/api/open/report/daily?startDate=2026-08-30&endDate=2026-09-05&groupBy=channel" \
-H "Authorization: Bearer invx_pk_你的APIKey"
# 查询店铺商品信息（主图 / 副图 / 定价 / 库存）
curl "https://invx.cn/api/open/product/list?pageNum=1&pageSize=20" \
-H "Authorization: Bearer invx_pk_你的APIKey"
# 暂停低效广告组（写操作，默认真实下发渠道后台）
curl -X PUT "https://invx.cn/api/open/ad/adgroup/status?groupId=120001" \
-H "Authorization: Bearer invx_pk_你的APIKey" \
-H "Content-Type: application/json" \
-d '{"status":"paused","pauseReason":"manual","pauseSource":"user"}'想用 AI 直接调数据？复制下面这段话，发给你的 AI 客户端 （OpenClaw 小龙虾 / Dify 扣子 / Coze 等），它会自动通过SkillHub 技能商店安装 Invx 官方 Skill「invx-ads-skill」，无需手动配置。
请先安装 SkillHub 技能商店 CLI（安装说明：https://skillhub.cn/install/skillhub.md），然后执行命令 skillhub install invx-ads-skill --dir <你的 AI 客户端 skills 目录>，安装 Invx 官方 Skill「invx-ads-skill」。这个 Skill 内置了 Invx 跨境电商广告平台的 22 个开放 API 定义，能帮我查询广告投放数据（按投放日真实指标 / 概览 / 趋势 / 渠道对比）、店铺商品信息（正标题 / 副标题 / 主副图 / 详情 / 定价 / 库存）、库存预警与补货建议、SKU 利润、Amazon 归因报表，还可以真实启停广告组（同步下发渠道后台）。安装后请配置环境变量 INVX_API_KEY（格式为 invx_pk_ 开头的字符串），后续我会直接让你用自然语言查询和分析这些数据。
22 个开放接口，覆盖查询到调优
基础地址 https://invx.cn/api/open，请求头携带Authorization: Bearer invx_pk_...
| 方法 | 接口 | 说明 | 权限 |
|---|---|---|---|
| 报表与概览 | |||
| GET | /dashboard | 投放概览：消耗 / 曝光 / 点击 / 转化 / 收入 / ROAS | read |
| GET | /report/daily | 按投放日真实指标（与工作台数据看板同源，币种拆分，跨度上限 92 天） | read |
| GET | /report/channel | 各广告渠道效果对比 | read |
| GET | /report/trend | 按天趋势分析 | read |
| 广告管理 | |||
| GET | /ad/campaign/list | 广告系列列表（需 channelId） | read |
| GET | /ad/adgroup/list | 广告组列表（可按渠道 / 系列过滤，含转化与 ROAS） | read |
| PUT | /ad/adgroup/status | 启停广告组：默认同步下发渠道后台，失败整体失败不落地 | write |
| 商品信息（Amazon SP-API / Shopee 同步） | |||
| GET | /product/list | 商品列表：正标题 / 副标题 / 主副图 / 定价 / 库存 / 商品链接 | read |
| GET | /product/detail | 商品详情（含详情描述 description 与副图数组） | read |
| 库存 | |||
| GET | /inventory/list | 库存快照与预警（in_stock / low_stock / out_of_stock） | read |
| GET | /inventory/restock-suggestions | 补货建议列表 | read |
| GET | /inventory/forecast | 断货风险预测 | read |
| GET | /inventory/pause-records | 缺货自动暂停广告记录 | read |
| 利润与优化 | |||
| GET | /profit/list | SKU 利润：广告费 / 成本 / 净利 / 利润率 | read |
| GET | /opportunity/score | 广告机会分与优化建议（account / campaign / adgroup） | read |
| 归因（Amazon Attribution） | |||
| GET | /attribution/tag | 归因标签（拼装带归因参数的落地页 URL） | read |
| GET | /attribution/report | 归因日报：点击 / 加购 / 购买 / 销售额 | read |
| 账户与资源 | |||
| GET | /channel/list | 已授权广告渠道账户列表 | read |
| GET | /shop/list | 店铺渠道列表 | read |
| GET | /material/list | 素材库（图片 / 视频 URL 与投放表现） | read |
| GET | /points/balance | AI 积分余额（三桶明细 + 峰谷时段倍率） | read |
| GET | /quota | API 调用配额使用情况 | read |
报表口径说明：/report/daily 按渠道侧真实投放日统计（推荐）；/dashboard、/report/trend、 /report/channel 为快照口径，二者与工作台数据看板的口径差异在 Skill 文档中有详细说明。
所有套餐都含 API 次数
用量在客户后台实时可见，额度不够随时扩容
| 套餐 | API Key 数量 | API 调用次数 |
|---|---|---|
| 30天免费试用 | 不限 | 100 次/月 |
| 标准版 | 不限 | 1,000 次/月 |
| 专业版 | 不限 | 10,000 次/月 |
| 企业版 | 不限 | 100,000 次/月 |
写操作（广告组启停）全套餐可用：创建 Key 时勾选「读写」，且成员角色需具备对应操作权限即可。
API 调用量扩容包
当月调用量不够用时随时加购，随买随用
- 每份每月 +10,000 次调用
- 立即生效，计入月配额
- 随订单自动开票
你可能想知道的
关于 AI 接入与 API Key 的疑问
API Key 是接入 Invx 开放接口的唯一凭证，格式为 invx_pk_ 开头的 32 位随机字符串。服务端仅存储其 SHA-256 哈希，明文只在创建时展示一次；支持随时禁用、吊销，吊销后立即失效。
无需安装任何插件。只要你的 AI 工具支持自定义 HTTP API 或 Function Calling（OpenClaw 小龙虾、Coze 扣子、Dify 等国产 AI 客户端均支持），将接口地址与 API Key 配置进去即可开始对话式查询与调优。
Key 的权限实时继承成员当前角色，不存权限快照。管理员调整角色或禁用成员后，该成员的 Key 权限在数秒内自动生效（数据范围与操作权限同步更新），无需重新生成 Key。
创建 Key 时可选择「只读」或「读写」。只有包含 write 权限的 Key 才能执行广告组启停等写操作，且该成员当前角色本身必须具备对应操作权限，双重校验。启停默认同步下发到渠道后台（Google / TikTok / Amazon / Meta），渠道下发失败时整体失败、平台内状态不变，保证两侧一致。
所有套餐都包含 API 调用次数（试用 100 次/月起），用量可在客户后台「API 用量」看板实时查看。不够时可购买「API 调用量扩容包」（¥99/份：每月 +10,000 次调用，有效期 1 年）或升级套餐。
商品数据来自渠道同步：Amazon 走 SP-API Listings（正标题 / bullet 副标题 / 主副图 / 详情 / 价格），Shopee 走开放平台商品接口（标题 / 图片 / 描述 / 价格 / 变体库存）。在客户后台绑定店铺并完成一次同步后即可通过 API 读取；渠道未返回的字段为空值，属正常现象。
现在注册，领取你的第一个 API Key
30 天全功能试用 + 100 次 API 调用额度，3 分钟接入你的 AI
