n8n-nodes-femini

这是一个 n8n 社区节点，用于查询 Femini 广告支出数据和管理信息。

功能特性

• 🔍 查询广告支出数据 - 支持多种分组和指标
• 📊 查询管理信息 - 获取直接支出、价格变更等管理数据
• 🔎 搜索 ID - 根据关键词搜索客户、合作伙伴和活动 ID

安装

在 n8n 中安装此社区节点：

npm install @feedmob/n8n-nodes-femini

或者在 n8n 界面中：

1. 进入 Settings > Community Nodes
2. 点击 Install
3. 输入 @feedmob/n8n-nodes-femini

凭据配置

此节点需要以下凭据：

• Femini API URL - Femini API 的基础 URL
• Femini API Token - Femini API 认证令牌
• Feedmob API Base URL - Feedmob API 的基础 URL
• Feedmob Key - Feedmob API 密钥
• Feedmob Secret - Feedmob API 密钥（用于 JWT 生成）

详细配置步骤请参考 CONFIGURATION_GUIDE.md

操作说明

1. Query Campaign Spends（查询广告支出）

查询广告活动的支出数据，支持灵活的分组和过滤。

默认配置（开箱即用）：

• ✅ Start Date - 自动设置为上月第一天
• ✅ End Date - 自动设置为昨天
• ✅ Groups - 默认为 campaign,partner
• ✅ Metrics - 默认为 gross,net
• ✅ 所有过滤条件 - 默认为空（查询所有数据）

参数说明：

• Start Date - 开始日期（YYYY-MM-DD 格式），默认：上月第一天
• End Date - 结束日期（YYYY-MM-DD 格式），默认：昨天
• Groups - 分组方式（逗号分隔），默认：campaign,partner
  • 可选值：day, week, month, client, partner, campaign, click_url, country
• Metrics - 指标（逗号分隔），默认：gross,net
  • 可选值：gross, net, revenue, impressions, clicks, installs, cvr, margin
• Client IDs (Optional) - 客户 ID 过滤（逗号分隔），留空查询所有客户
• Partner IDs (Optional) - 合作伙伴 ID 过滤（逗号分隔），留空查询所有合作伙伴
• Campaign IDs (Optional) - 活动 ID 过滤（逗号分隔），留空查询所有活动
• Click URL IDs (Optional) - 点击 URL ID 过滤（逗号分隔），留空查询所有点击 URL

快速开始： 配置好凭据后，无需修改任何参数即可直接执行，将自动查询上月至昨天的所有广告支出数据。

自定义示例：

Groups: campaign,partner,country
Metrics: gross,net,margin,cvr
Start Date: 2025-01-01
End Date: 2025-01-31
Client IDs: 123,456

2. Query Admin Information（查询管理信息）

查询管理系统中的各种数据，包括直接支出、价格变更日志等。

默认配置（开箱即用）：

• ✅ Start Date - 自动设置为上月第一天
• ✅ End Date - 自动设置为昨天
• ✅ Admin Metrics - 默认为 infomation
• ✅ 所有过滤条件 - 默认为空（查询所有数据）

参数说明：

• Start Date - 开始日期，默认：上月第一天
• End Date - 结束日期，默认：昨天
• Admin Metrics - 管理指标（逗号分隔），默认：infomation
  • infomation - 基本信息
  • direct_spends - 直接支出
  • direct_spend_with_change_logs - 带变更日志的直接支出
  • infomation_with_change_logs - 带变更日志的信息
  • price_rate_change_logs - 价格变更日志
  • spend_requests - 支出请求
  • spend_request_with_change_logs - 带变更日志的支出请求
• 过滤条件（可选） - Client IDs, Partner IDs, Campaign IDs, Click URL IDs

快速开始： 配置好凭据后，无需修改任何参数即可直接执行，将自动查询上月至昨天的基本管理信息。

3. Search IDs（搜索 ID）

根据关键词搜索客户、合作伙伴和活动的 ID 信息。

参数：

• Keywords - 搜索关键词（逗号分隔）

注意： femini, assistant, feedmob 是系统关键词，无需查询 ID。

使用示例

示例 1：快速开始（使用默认参数）

1. 添加 Femini 节点
2. 配置凭据（Femini API 和 Feedmob API）
3. 选择操作：Query Campaign Spends
4. 直接执行 - 无需修改任何参数！
   • 自动查询上月第一天到昨天的数据
   • 按 campaign 和 partner 分组
   • 返回 gross 和 net 指标

示例 2：自定义查询特定时间段

1. 添加 Femini 节点
2. 选择操作：Query Campaign Spends
3. 修改参数：
   • Groups: client,country
   • Metrics: gross,net,margin,cvr
   • Start Date: 2025-01-01
   • End Date: 2025-01-31
4. 执行节点

示例 3：搜索特定客户的 ID

1. 添加 Femini 节点
2. 选择操作：Search IDs
3. 输入关键词：uber,lyft
4. 执行节点获取 ID 列表

示例 4：查询特定客户的管理信息

1. 添加 Femini 节点
2. 选择操作：Query Admin Information
3. 设置参数：
   • Admin Metrics: infomation,direct_spends
   • Client IDs: 123,456（从示例 3 获取）
4. 执行节点

示例 5：查询特定合作伙伴的支出

1. 添加 Femini 节点
2. 选择操作：Query Campaign Spends
3. 设置参数：
   • Partner IDs: 101,102
   • 其他参数保持默认
4. 执行节点

数据库架构

详细的数据库架构和查询示例请参考 femini_mcp_guide.md。

开发

# 安装依赖
npm install

# 构建
npm run build

# 开发模式（监听文件变化）
npm run dev

许可证

MIT License