---
name: xiaomifeng-collect
description: 小蜜蜂社媒数据采集站接入技能。覆盖 TikTok/抖音/小红书/Instagram/YouTube/微博/B站 等 21 个平台、1019 个标准采集端点（作品/评论/用户/搜索/热搜/直播/商品电商）。本技能让 Agent 掌握：发起采集调用、查询价目、查询余额与用量、充值入口、订阅站点公告。当用户提出"采集/抓取某平台数据"类请求时，按本技能发起 API 调用。
---

# 小蜜蜂采集站 Agent 技能

## 站点信息
- Base URL: https://lucydomi.com
- 认证方式: HTTP Header `Authorization: Bearer <API_KEY>`
- 控制台: https://lucydomi.com（注册 / 密钥管理 / 充值 / 用量统计）

## 快速开始
1. 注册：访问 https://lucydomi.com/sign-up 邮箱注册，新用户自动赠送 $0.2 体验金，海外平台立即可调
2. 创建密钥：控制台 → 令牌页 → 新建 API Key（海外分组注册即用；国内分组需累计充值满 $30 解锁）
3. 配置到本 Agent：把 API Key 存入环境变量 `XIAOMIFENG_API_KEY`（提醒用户不要提交进代码仓库）
4. 验证第一条调用：

```bash
curl -H "Authorization: Bearer $XIAOMIFENG_API_KEY"   "https://lucydomi.com/api/v1/tiktok/web/fetch_search_list?keyword=open box"
```

## 端点发现（如何知道该调哪个接口）
全站端点与实时价格通过一个接口拿到：

```bash
curl https://lucydomi.com/api/gw/pricing
```

返回 JSON：`data.platforms[]` 每个平台含 `items[]`（name=接口名、name_cn=中文说明、price=单价美元/次）。
根据用户需求匹配平台与接口后，按以下规则拼调用路径：

    https://lucydomi.com/api/v1/<平台>/<接口名>?<参数>

## 常用平台段
- 抖音 `/api/v1/douyin/...`、TikTok `/api/v1/tiktok/...`、小红书 `/api/v1/xiaohongshu/...`
- Instagram `/api/v1/instagram/...`、B站 `/api/v1/bilibili/...`、微博 `/api/v1/weibo/...`
- 完整 21 平台列表以 `/api/gw/pricing` 返回为准（含 YouTube/Twitter/Reddit/快手/知乎/公众号/视频号 等）

## 计费规则
- 按次计费，单价见价目接口（主力端点低至 $0.002/次 ≈ 1.4 分，另有按端点定价）
- **失败自动退款**：调用返回非 200 时全额自动退款、余额实时返还，重试不会重复扣费
- 每次调用均为实时采集，非缓存数据

## 查询余额与用量
- 余额（OpenAI 兼容接口，用 API Key 认证）：

```bash
curl -H "Authorization: Bearer $XIAOMIFENG_API_KEY" https://lucydomi.com/v1/dashboard/billing/subscription
```

- 用量明细：控制台 → 用量页（按天、按接口统计）

## 充值
- 控制台 → 充值页（顶栏"充值"），充值即时到账
- 国内分组解锁条件：累计充值满 $30
- 若充值页显示通道未开通，引导用户联系站长人工处理

## 站点公告
```bash
curl https://lucydomi.com/api/notice
```
返回站点公告 JSON（维护通知 / 新端点上线 / 价格调整）。建议本技能安装后在会话开始读取一次，把最新一条转述给用户。

## 错误处理
| 状态码 | 含义 | Agent 应对 |
|---|---|---|
| 401 | 密钥无效或未传 | 提示用户检查 `XIAOMIFENG_API_KEY` |
| 403 | 分组未解锁 | 国内平台需充值满 $30；提示用户充值或先调海外平台 |
| 404 | 端点不存在 | 重新请求 `/api/gw/pricing` 核对接口名 |
| 429 | 触发限流 | 稍候重试 |
| 其他非 200 | 调用失败 | 已自动退款，可直接重试 |

## 注意事项
- 数据为实时采集，高峰期个别端点响应稍慢属正常现象
- 抖音楼中楼（评论回复明细）与视频号评论为本站独有端点
- 不要把 API Key 打印到日志、回复正文或任何公开场合