aiconductor-cli 1.6.0 → 1.7.0

package/api_docs/xhs_note_search_v2.md

@@ -1,73 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_note_search_v2`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据关键词搜索小红书笔记，支持自动翻页，使用 max_pages 和 max_seconds 控制翻页范围。按页计费，每页计费一次。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| keyword | string | 是 | | 搜索关键词 |
-| max_pages | integer | 否 | 1 | 最大翻页数 |
-| max_seconds | integer | 否 | 50 | 最长运行时长（秒），超时自动停止 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| data | object | 搜索结果数据 |
-| data.has_more | boolean | 是否还有更多数据 |
-| data.items | array | 笔记列表 |
-| data.items[].noteInfo | object | 笔记信息 |
-| data.items[].noteInfo.noteId | string | 笔记ID |
-| data.items[].noteInfo.title | string | 笔记标题 |
-| data.items[].noteInfo.noteType | integer | 笔记类型（1=图文，2=视频） |
-| data.items[].noteInfo.notePublishTime | string | 发布时间 |
-| data.items[].noteInfo.noteLink | string | 笔记链接 |
-| data.items[].noteInfo.likeNum | integer | 点赞数 |
-| data.items[].noteInfo.favNum | integer | 收藏数 |
-| data.items[].noteInfo.cmtNum | integer | 评论数 |
-| data.items[].noteInfo.readNum | integer | 浏览数 |
-| data.items[].noteInfo.videoUrl | string | 视频URL（图文笔记为空） |
-| data.items[].noteInfo.videoDuration | integer | 视频时长（秒） |
-| data.items[].noteInfo.noteImages | array | 图片列表 |
-| data.items[].noteInfo.noteImages[].imageUrl | string | 图片URL |
-| data.items[].noteInfo.noteImages[].imageWidth | integer | 图片宽度 |
-| data.items[].noteInfo.noteImages[].imageHeight | integer | 图片高度 |
-| data.items[].userInfo | object | 用户信息 |
-| data.items[].userInfo.nickName | string | 用户昵称 |
-| data.items[].userInfo.avatar | string | 用户头像URL |
-| data.items[].userInfo.userId | string | 用户ID |
-| data.items[].userInfo.fansNum | integer | 粉丝数 |
-| billing | object | 计费信息 |
-| billing.service_fee | float | 单页服务费 |
-| billing.discount_applied | boolean | 是否应用折扣 |
-| billing.balance_before | float | 扣费前余额 |
-| billing.balance_after | float | 扣费后余额 |
-| billing.currency | string | 货币类型（CNY） |
-| billing.pages_billed | integer | 实际计费页数 |
-| billing.total_service_fee | float | 总服务费 |
-| billing.transaction_ids | array | 交易ID列表 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_note_search_v2" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"keyword": "人民日报", "max_pages": 2, "max_seconds": 60}'
-```
-
-## 注意事项
-1. 按页计费，每成功获取一页数据扣费一次
-2. max_pages 控制最大翻页数，max_seconds 控制最长运行时间，两者任一达到限制即停止
-3. 余额不足时自动停止翻页，已获取的数据正常返回
-4. 采用后扣费模式，仅成功获取数据的页面才计费

package/api_docs/xhs_note_search_v3.md

@@ -1,54 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_note_search_v3`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-小红书笔记搜索插件 V3，基于 TikHub API，支持关键词搜索与自动翻页（search_id 机制），按页计费。费用以 api_services 表配置为准（service_code: `xhs_note_search_v3`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| keyword | string | 是 | — | 搜索关键词 |
-| max_pages | int | 否 | 1 | 最大翻页数 |
-| max_seconds | int | 否 | 50 | 最长运行时长（秒） |
-| page | int | 否 | 1 | 起始页码 |
-| sort | string | 否 | "" | 排序方式：`general` / `time_descending` / `popularity_descending` / `comment_descending` / `collect_descending`（空=general） |
-| note_type | string | 否 | "" | 笔记类型：`video` / `note` / 空（不限） |
-| note_time | string | 否 | "" | 发布时间：`day` / `week` / `halfyear` / 空（不限） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| billing | object | 计费信息（service_fee / discount_applied / balance_before / balance_after / currency / pages_billed / total_service_fee / transaction_ids） |
-| data.has_more | boolean | 是否还有更多数据 |
-| data.items | array[object] | 笔记列表 |
-| data.items[].noteInfo | object | 笔记信息（见下） |
-| data.items[].userInfo | object | 用户信息（见下） |
-
-`data.items[].noteInfo` 字段：`noteId`(string)、`title`(string)、`noteType`(string)、`notePublishTime`(string)、`noteLink`(string)、`likeNum`(int)、`favNum`(int)、`cmtNum`(int)、`readNum`(int)、`videoUrl`(string)、`videoDuration`(int)、`desc`(string)、`noteImages`(array[{imageUrl, imageWidth, imageHeight}])。
-
-`data.items[].userInfo` 字段：`nickName`(string)、`avatar`(string)、`userId`(string)、`fansNum`(int)。
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_note_search_v3" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"keyword": "美食探店", "max_pages": 2, "note_type": "video", "sort": "popularity_descending"}'
-```
-
-## 注意事项
-1. 按页计费：每成功抓取一页计费一次，余额不足、超时或上游无更多数据会自动停止翻页。
-2. 采用后扣费模式：仅当某页成功获取并解析后才扣费，失败不扣费。
-3. 翻页由内部维护 `search_id` / `search_session_id`，调用方无需关心。
-4. 上游单页请求超时 55s，单次搜索最多重试 3 次。
-5. 上游返回业务错误或无数据时停止翻页，已抓取数据仍正常返回。

package/api_docs/xhs_user_info_v2.md

@@ -1,61 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_user_info_v2`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据用户ID获取小红书用户详情，包括基本信息、互动数据（关注/粉丝/获赞与收藏/获赞/收藏）、标签等。按次计费。
-
-> **数据源变更（2026-11-05）**：上游由 YDDM `/xhs/user_detail`（实测 8.2s）切换为 TikHub `GET /api/v1/xiaohongshu/app_v2/get_user_info`（实测 2.3s），**入参与出参形状完全不变**：
-> `user_info.basic_info{nickname, avatar, red_id, gender, ip_location, desc}` + `user_info.interactions[5]{type, name, count}`（关注/粉丝/获赞与收藏/获赞/收藏）+ `user_info.tags[string]`。
-> 两个口径差异需知悉：① `ip_location` 统一给**中文省份**（优先取资料地区省份，回落英文 IP 归属地，如 `福建`）；② `获赞与收藏` 取上游自带的合计值，缺失时用 `获赞 + 收藏` 兜底。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| user_id | string | 是 | | 小红书用户ID，从用户主页链接 `/user/profile/` 后提取 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| user_info | object | 用户详情数据 |
-| user_info.basic_info | object | 基本信息 |
-| user_info.basic_info.nickname | string | 用户昵称 |
-| user_info.basic_info.avatar | string | 用户头像URL |
-| user_info.basic_info.red_id | string | 小红书号 |
-| user_info.basic_info.gender | integer | 性别（0=未知，1=男，2=女） |
-| user_info.basic_info.ip_location | string | IP归属地 |
-| user_info.basic_info.desc | string | 个人简介 |
-| user_info.interactions | array | 互动数据列表 |
-| user_info.interactions[].type | string | 互动类型（follows/fans/interaction） |
-| user_info.interactions[].name | string | 互动名称（关注/粉丝/获赞与收藏） |
-| user_info.interactions[].count | integer | 互动数量 |
-| user_info.tags | array | 标签列表 |
-| billing | object | 计费信息 |
-| billing.service_fee | float | 服务费 |
-| billing.discount_applied | boolean | 是否应用折扣 |
-| billing.balance_before | float | 扣费前余额 |
-| billing.balance_after | float | 扣费后余额 |
-| billing.currency | string | 货币类型（CNY） |
-| billing.transaction_id | string | 交易ID |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_user_info_v2" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"user_id": "6229d4850000000021021d46"}'
-```
-
-## 注意事项
-1. user_id 从小红书用户主页链接中提取，格式为 `https://www.xiaohongshu.com/user/profile/{user_id}`
-2. 采用后扣费模式，仅用户详情获取成功时才扣费
-3. 用户可能设置隐私权限导致部分数据不可见，此时正常返回可见数据

package/api_docs/xhs_user_notes_v2.md

@@ -1,56 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_user_notes_v2`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据用户ID获取小红书用户笔记列表，支持自动翻页，使用 max_pages 和 max_seconds 控制翻页范围。按页计费，每页计费一次。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| user_id | string | 是 | | 小红书用户ID，从用户主页链接 `/user/profile/` 后提取 |
-| max_pages | integer | 否 | 1 | 最大翻页数 |
-| max_seconds | integer | 否 | 50 | 最长运行时长（秒），超时自动停止 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| data | object | 笔记列表数据 |
-| data.notes | array | 笔记列表 |
-| data.notes[].noteId | string | 笔记ID |
-| data.notes[].title | string | 笔记标题 |
-| data.notes[].type | string | 笔记类型（video/normal） |
-| data.notes[].time | integer | 发布时间（毫秒时间戳） |
-| billing | object | 计费信息 |
-| billing.service_fee | float | 单页服务费 |
-| billing.discount_applied | boolean | 是否应用折扣 |
-| billing.balance_before | float | 扣费前余额 |
-| billing.balance_after | float | 扣费后余额 |
-| billing.currency | string | 货币类型（CNY） |
-| billing.pages_billed | integer | 实际计费页数 |
-| billing.total_service_fee | float | 总服务费 |
-| billing.transaction_ids | array | 交易ID列表 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_user_notes_v2" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"user_id": "5e7e31a20000000001004b48", "max_pages": 3, "max_seconds": 120}'
-```
-
-## 注意事项
-1. 按页计费，每成功获取一页数据扣费一次
-2. max_pages 控制最大翻页数，max_seconds 控制最长运行时间，两者任一达到限制即停止
-3. 余额不足时自动停止翻页，已获取的数据正常返回
-4. 采用后扣费模式，仅成功获取数据的页面才计费
-5. user_id 从小红书用户主页链接中提取，格式为 `https://www.xiaohongshu.com/user/profile/{user_id}`

package/api_docs/xhs_user_notes_v3.md

@@ -1,48 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_user_notes_v3`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据用户 ID 获取小红书用户笔记列表，支持自动翻页（cursor 机制），兼容图文与视频笔记，按页计费。费用以 api_services 表配置为准（service_code: `xhs_user_notes_v2`）。
-
-> **数据源变更（2026-11-05）**：上游由 YDDM `/xhs/user_post2`（持续返回 `code 5003 网络连接失败`，接口表现为 `success:true` + 空 `notes`）切换为 TikHub `GET /api/v1/xiaohongshu/app_v2/get_user_posted_notes`（实测 20 条/页、1.9s）。**入参与出参形状完全不变**，与 `xhs_user_notes_v2` 同一上游、同一输出结构（差别只在 `desc` 等字段的原始内容）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| user_id | string | 是 | — | 小红书用户 ID |
-| max_pages | int | 否 | 1 | 最大翻页数 |
-| max_seconds | int | 否 | 50 | 最长运行时长（秒） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| billing | object | 计费信息（service_fee / discount_applied / balance_before / balance_after / currency / pages_billed / total_service_fee / transaction_ids） |
-| data.notes | array[object] | 笔记列表（见下） |
-
-`data.notes[]` 字段：`noteId`(string)、`time`(int, 毫秒时间戳)、`title`(string)、`type`(string, normal/video)、`desc`(string)、`time_desc`(string)、`likes`(int)、`comments_count`(int)、`collected_count`(int)、`shared_count`(int)、`ip_location`(string)、`sticky`(bool)、`is_goods_note`(bool)、`has_music`(bool)、`user`(object{user_id, nickname, avatar})、`images`(array[{url, url_size_large, width, height}])。
-视频笔记额外包含 `video`(object)：`duration`(int)、`width`(int)、`height`(int)、`cover_url`(string)、`thumbnail_url`(string)、`streams`(array[{codec, quality, url, backup_urls, width, height, duration, fps, format, size}])。
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_user_notes_v3" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"user_id": "5f8e9c1b0000000001001a2b", "max_pages": 3}'
-```
-
-## 注意事项
-1. 按页计费：每成功获取一页计费一次，余额不足、超时或上游无更多数据自动停止翻页。
-2. 采用后扣费模式：仅成功获取并解析后才扣费，失败不扣费。
-3. 翻页由内部维护 `cursor`（取每页最后一条笔记的 cursor），调用方无需关心。
-4. 返回数据同时兼容图文（normal）与视频（video）笔记，视频笔记带 streams 流信息。
-5. 上游单页请求超时 55s，最多重试 3 次。