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 - 开始日期（YYYY-MM-DD 格式）
• End Date - 结束日期（YYYY-MM-DD 格式）
• Groups - 分组方式（逗号分隔）：day, week, month, client, partner, campaign, click_url, country
• Metrics - 指标（逗号分隔）：gross, net, revenue, impressions, clicks, installs, cvr, margin
• Client IDs - 客户 ID 过滤（逗号分隔）
• Partner IDs - 合作伙伴 ID 过滤（逗号分隔）
• Campaign IDs - 活动 ID 过滤（逗号分隔）
• Click URL IDs - 点击 URL ID 过滤（逗号分隔）

示例：

Groups: campaign,partner
Metrics: gross,net,margin
Start Date: 2025-01-01
End Date: 2025-01-31

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

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

参数：

• Start Date - 开始日期
• End Date - 结束日期
• Admin Metrics - 管理指标（逗号分隔）：
  • 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. 选择操作：Query Campaign Spends
3. 设置参数：
   • Groups: client
   • Metrics: gross,net
   • Start Date: 2025-01-01
   • End Date: 2025-01-31
4. 执行节点

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

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

示例 3：查询管理信息

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

数据库架构

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

开发

# 安装依赖
npm install

# 构建
npm run build

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

许可证

MIT License