npm package: @feedmob/n8n-nodes-femini
Description: n8n nodes for Femini Reporting (wraps MCP tools) - Now with smart defaults for instant use
Author: FeedMob
Latest version: 0.1.5

# n8n-nodes-femini

这是一个 n8n 社区节点，用于查询 Femini 广告支出数据和管理信息。

## 功能特性

- 🔍 **查询广告支出数据** - 支持多种分组和指标
- 📊 **查询管理信息** - 获取直接支出、价格变更等管理数据
- 🔎 **搜索 ID** - 根据关键词搜索客户、合作伙伴和活动 ID

## 安装

在 n8n 中安装此社区节点：

```bash
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](https://github.com/feed-mob/fm-mcp-servers/blob/main/src/n8n-nodes-femini/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](./femini_mcp_guide.md)。

## 开发

```bash
# 安装依赖
npm install

# 构建
npm run build

# 开发模式（监听文件变化）
npm run dev
```

## 许可证

MIT License