n8n 节点：Sensor Tower Reporting

将 Sensor Tower Reporting MCP 工具封装为 n8n 社区节点，便于在工作流中直接拉取应用情报与市场数据。

安装（本地开发）

cd src/n8n-nodes-sensor-tower
npm install
npm run build

在你的 n8n 实例中，以“社区节点”的方式加载该文件夹（或发布到 npm 后按包名安装）。

安装（n8n 使用 npm 包）

• 在 n8n（包括 n8n Cloud）后台，进入 Community Nodes → Install，输入包名 @feedmob/n8n-nodes-sensor-tower 并安装。
• 自托管（Docker/K8s 等）可通过环境变量安装：

# 例如 Docker 环境
-e N8N_COMMUNITY_PACKAGES="@feedmob/n8n-nodes-sensor-tower"

如在 n8n Cloud，请确保组织已启用 “Community Nodes”。

凭据（Credentials）

• Base URL：可选，默认 https://api.sensortower.com
• Auth Token：必填，你的 Sensor Tower API AUTH_TOKEN

在 n8n 中创建类型为 “Sensor Tower API” 的凭据，并填入上述字段。

支持的操作（Operations）

• Get App Metadata：获取应用元数据（名称、开发者、分类、描述、截图、评分等）
• Get Top In-App Purchases（iOS）：获取 iOS 应用的内购热度榜
• Get Compact Sales Report Estimates：获取紧凑格式的下载与收入预估（单位为分）
• Get Active Users：获取按国家维度的活跃用户（DAU/WAU/MAU）
• Get Category History：获取应用在分类榜单的历史排名（支持小时级别，仅 iOS）
• Get Category Ranking Summary：获取当天的分类榜单概览
• Get Network Analysis：广告情报的曝光份额（SOV）时序
• Get Network Analysis Rank：广告情报的排名数据
• Get Retention：按 D1~D90 的留存数据（含基线）
• Get Downloads By Sources：按来源（自然、付费、浏览器）拆分下载量

上述操作与 MCP 工具保持一致，仅对 n8n 的交互做了少量字段/校验优化。

参数要点

• 日期格式统一为 YYYY-MM-DD
• 多个 ID 支持用英文逗号分隔，例如 123,456,789
• publisher_ids 为“可重复的查询参数”，节点内部已按 publisher_ids[] 方式正确编码
• iOS/Android 需通过 OS 选项明确选择

典型用法

1. 在工作流中拖入 “Sensor Tower” 节点
2. 选择所需 Operation，并填写参数
3. 选择已创建的 “Sensor Tower API” 凭据
4. 运行节点，结果将以 JSON 形式输出到后续节点

构建脚本

• npm run build：TypeScript 编译并拷贝图标到 dist
• npm run dev：监听编译（可按需添加）

备注

• 节点仅负责拼装并转发请求到 Sensor Tower API，HTTP 错误将以 JSON 形式透出，便于在工作流中处理
• 如需新增 API 映射，可在 nodes/SensorTower/SensorTower.node.ts 中扩展 Operation 与参数