redfox-communityBLOCK

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

.
├── README.md          # 本说明(中文)
├── README.en.md       # English README
├── skills/            # 技能(每个子目录一枚技能)
│   └── /
│       ├── SKILL.md
│       └── ...          # 脚本、参考文档等(可选)

---
name: Example Skill
description: 一句话说明技能适用场景与能力边界(建议具体,避免空泛)。
---

请帮我在当前工作区检查并安装以下 Agent Skill。

Skill:小红书最新热门笔记 / xiaohongshu-realtime-search
源码地址:https://github.com/redfox-data/redfox-community/tree/m

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: account-video-downloader
description: 多平台账号主页视频提取器 — 输入平台名称和账号id/链接,自动拉取抖音/快手/B站/YouTube 四大平台主页作品,解析下载链接,支持批量下载。适用场景:竞品账号内容拆解与逐帧学习、收藏喜欢的创作者全部作品避免被删、批量搬运素材二次剪辑创作、保存自己账号作品做本地备份防丢失、课程/教程类视频离线囤货反复看、达人合作前快速拉取对方作品做背调分析。触发词:主页视频下载、批量下载视频、账号视频提取、快手主页下载、B站视频提取、YouTube频道下载、视频保存、无水印下载、竞品视频下载、博主视频备份。
---

# 多平台账号主页视频提取器

> 输入平台 + 账号 → 拉取作品列表 → 解析下载链接 → 一键下载到本地

---

## 简介

多平台账号主页视频批量下载工具。支持 **抖音、快手、B站、YouTube** 四大平台,只需提供平台名称和账号标识,自动拉取该账号近期作品列表,逐条解析视频/图文下载直链,支持一键批量下载到本地。

---

## 功能特性

| 功能        | 说明                                                 |
| ----------- | ---------------------------------------------------- |
| 📋 作品拉取 | 通过账号获取主页近期作品(标题、互动数据、作品链接) |
| 🔗 链接解析 | 逐条调用解析接口,获取视频/图文下载直链              |
| 📥 批量下载 | 一键下载全部作品(视频+图文)到本地 `output/` 目录   |
| 📊 数据展示 | Markdown 表格 / JSON 双格式输出,含完整互动数据      |
| 📄 分页翻页 | 支持翻页查看更多作品                                 |
| 📅 日期筛选 | 可按作品发布时间挑选                                 |
| 🌐 多平台   | 一个工具覆盖抖音/快手/B站/YouTube 四大平台           |

---

## 支持平台

| --platform | 平台     | 账号标识               | 说明                                   |
| :--------- | :------- | :--------------------- | :------------------------------------- |
| `douyin`   | 抖音     | 抖音号                 | 如 `Fish688688`                        |
| `kuaishou` | 快手     | 快手号                 | 如 `Fish688688`                        |
| `bilibili` | 哔哩哔哩 | 主页链接(accountUrl) | 如 `https://space.bilibili.com/123456` |
| `youtube`  | YouTube  | 频道 URL(channel)    | 如 `https://www.youtube.com/@channel`  |

---

## API 说明

本 Skill 调用 redfox.hk 接口,每个平台分两步:

| 步骤        | 接口路径                                             | 说明                     |
| ----------- | ---------------------------------------------------- | ------------------------ |
| 1. 拉取作品 | `POST /story/api/{platform}/...`                     | 根据账号标识获取作品列表 |
| 2. 解析下载 | `POST /story/api/parseWork/videoDownload/{platform}` | 根据作品链接获取下载直链 |

### 认证

前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API Key,设为环境变量:

```bash
# macOS / Linux
export REDFOX_API_KEY=ak_你的密钥

# Windows PowerShell
$env:REDFOX_API_KEY="ak_你的密钥"
```

---

## 使用方式

### CLI 命令行

```bash
# 抖音:基础用法
python3 "$SKILL_PATH/scripts/main.py" --platform douyin --account "Fish688688"

# 快手:基础用法
python3 "$SKILL_PATH/scripts/main.py" --platform kuaishou --account "kwaiId"

# B站:拉取作品并解析下载链接(不下载文件)
python3 "$SKILL_PATH/scripts/main.py" --platform bilibili --account "https://space.bilibili.com/123456"

# YouTube:下载视频到本地
python3 "$SKILL_PATH/scripts/main.py" --platform youtube --account "https://www.youtube.com/@channel" --download

# YouTube:指定下载目录
python3 "$SKILL_PATH/scripts/main.py" --platform youtube --account "https://www.youtube.com/@channel" --download --output-dir ./my_videos

# 指定作品数量(默认10,最多50)
python3 "$SKILL_PATH/scripts/main.py" --platform bilibili --account "MID" --count 20 --download

# 翻页查看更多作品
python3 "$SKILL_PATH/scripts/main.py" --platform kuaishou --account "用户ID" --page 2

# 按日期范围筛选作品
python3 "$SKILL_PATH/scripts/main.py" --platform bilibili --account "MID" --date-start 2026-07-01 --date-end 2026-07-31

# 多账号(逗号分隔)
python3 "$SKILL_PATH/scripts/main.py" --platform bilibili --accounts "MID1,MID2" --download

# 组合使用:第2页 + 日期过滤 + 下载
python3 "$SKILL_PATH/scripts/main.py" --platform bilibili --account "MID" --page 2 --count 20 --date-start 2026-06-01 --download
```

### 参数说明

| 参数           | 说明                           |
| -------------- | ------------------------------ |
| `--platform`   | 目标平台(必填,见上表)       |
| `--account`    | 单个账号标识                   |
| `--accounts`   | 多个账号标识,逗号分隔         |
| `--count`      | 拉取作品数量(默认10,最多50) |
| `--page`       | 页码(默认1)                  |
| `--date-start` | 起始日期 YYYY-MM-DD            |
| `--date-end`   | 结束日期 YYYY-MM-DD            |
| `--download`   | 下载视频文件到本地             |
| `--output-dir` | 下载目录(默认 `output/`)     |
| `--json`       | JSON 格式输出                  |
| `--rate-limit` | 请求间隔秒数(默认 1.0)       |

### 依赖

| 依赖       | 安装命令                |
| ---------- | ----------------------- |
| `requests` | `pip3 install requests` |

---

## 账号标识要求

不同平台对账号标识有不同要求,**必须提供各平台的唯一标识**:

| 平台    | 要求                   | URL 支持  | 获取方式                                          |
| :------ | :--------------------- | :-------- | :------------------------------------------------ |
| B站     | 主页链接(accountUrl) | ✅ 支持   | 直接复制个人空间页 URL                            |
| YouTube | 频道 URL(channel)    | ✅ 支持   | 直接复制频道页 URL                                |
| 抖音    | 抖音号(uniqueName)   | ❌ 不支持 | 抖音 APP → 目标主页 → 头像下方「抖音号:xxx」字段 |
| 快手    | 账号 ID(kwaiId)      | ❌ 不支持 | 快手 APP → 目标主页 → 昵称下方显示的 ID           |

> ⚠️ **抖音、快手不支持主页链接!** 如果用户粘贴了 URL,必须提示用户提供上述唯一标识。

**重要:** 若用户只输入账号名称而未提供唯一标识,必须提示用户提供准确的唯一标识。

> 📸 **抖音号获取方式:** 打开抖音 APP → 进入目标用户主页 → 在头像下方、粉丝数据下方可看到「抖音号:xxx」字段。若用户不确定抖音号在哪,可展示示意截图(红框标注「抖音号」位置)帮助用户定位。

---

## Agent 集成指南

### 触发词

- 主页视频下载 / 批量下载视频 / 账号视频提取
- 抖音下载 / 抖音视频提取 / 下载抖音作品
- B站视频提取 / B站视频下载 / 哔哩哔哩视频下载
- YouTube频道下载 / YouTube视频提取
- 帮我下载 xxx 的主页视频

### Agent 执行流程

```
Step 1: 确认用户意图、平台与账号标识
  - 从用户输入中识别目标平台(抖音/快手/B站/YouTube)
  - 若用户未明确平台,询问:「你想下载哪个平台的视频?」
  - 确认账号标识格式正确,若用户提供的是中文昵称,提示提供唯一 ID

Step 2: 识别用户输入的时间范围(如有)
  - 若用户提到了作品时间范围,自动识别并转换为 --date-start / --date-end:
    - "7.1~7.20" → --date-start 2026-07-01 --date-end 2026-07-20
    - "7月1日到7月20日" → --date-start 2026-07-01 --date-end 2026-07-20
    - "最近一周" → 当前日期往前推 7 天
    - "上个月" → 上个月 1 日到上个月最后一天
    - "7月份的作品" → --date-start 2026-07-01 --date-end 2026-07-31
  - 日期格式固定为 YYYY-MM-DD,年份默认为当前年份
  - 若用户要求"继续"/"下一页",添加 --page N

Step 3: 调用脚本拉取作品 + 解析下载链接
  python3 "$SKILL_PATH/scripts/main.py" --platform <platform> --account "<id>"

Step 4: 展示结果 + 询问翻页
  - 展示 Markdown 表格,含可点击的作品链接和下载链接
  - 若有失败:提示「可能是用户已删除该视频,如需数据核查可联系工作人员邮箱 [email protected] 处理」
  - 若可翻页:告诉用户「还有更多作品,是否需要翻看下一页?」,输入下一页翻页
  - 提示用户支持按时间范围提取作品

Step 5: 询问用户是否需要批量下载
  - 使用 AskUserQuestion:「是否需要将能下载的视频批量下载到本地?」
  - 选项:「下载到本地」/「只看链接即可」

Step 6: 用户确认后执行下载
  python3 "$SKILL_PATH/scripts/main.py" --platform <platform> --acco

BLOCKgrade F · trust 29/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.

What the source does

Filesystem

none-observed

Network

declared (9 observation(s))

Shell

declared (8 observation(s))

Dependencies

pinned

Secrets in source

found

Findings (25)

"pictureUrl": "https://favikon-medias.s3.eu-west-3.amazonaws.com/yt/UCBJycsmduvYEL83R_U4JriQ.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVSTJR7ZBRQ7

"pictureUrl": "https://favikon-medias.s3.eu-west-3.amazonaws.com/tw/1720665183188922368.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVSTJR7ZBRQ76TM7R

"pictureUrl": "https://favikon-medias.s3.eu-west-3.amazonaws.com/yt/UCey_c7U86mJGz1VJWH5CYPA.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVSTJR7ZBRQ7

"pictureUrl": "https://favikon-medias.s3.eu-west-3.amazonaws.com/yt/UCWFKCr40YwOZQx8FHU_ZqqQ.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVSTJR7ZBRQ7

"pictureUrl": "https://favikon-medias.s3.eu-west-3.amazonaws.com/tw/432943643.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVSTJR7ZBRQ76TM7R%2F2026092

exec(open('scripts/douyin_similar_account.py', encoding='utf-8').read())

# Bilibili Portfolio Search / bilibili-portfolio-search

# B站搜账号下作品集 / bilibili-portfolio-search

# Core Workflow

# 全网内容出海信息源 - 核心工作流程

# 全网内容出海信息源 - 使用示例

.DS_Store

print(RED + '║  echo \'{"api_key":"ak_你的密钥"}\' > ~/.qoder/apis/redfox.json ║' + RESET)

print(RED + '║  echo \'{"api_key":"ak_你的密钥"}\' > ~/.qoder/apis/redfox.json ║' + RESET)

print(RED + '║  echo \'{"api_key":"ak_你的密钥"}\' > ~/.qoder/apis/redfox.json ║' + RESET)

print(RED + '║  echo \'{"api_key":"ak_你的密钥"}\' > ~/.qoder/apis/redfox.json ║' + RESET)

print("  2. 配置文件:echo '{\"api_key\":\"ak_你的密钥\"}' > ~/.qoder/apis/redfox.json", file=sys.stderr)

subprocess.run(["launchctl", "load", str(plist_path)], check=True, capture_output=True)

f'(crontab -l 2>/dev/null; echo "{cron_line}") | crontab -',

info("订阅成功! 每天 09:00 自动生成B站爆款日报 (crontab)")

warn("自动配置 crontab 失败,请手动添加:")

subprocess.run(["launchctl", "unload", str(plist_path)], check=True, capture_output=True)

info(f"本地服务已启动: http://127.0.0.1:{port}")

url = f"http://127.0.0.1:8765/{filename}"

info(f"本地服务已启动: http://127.0.0.1:{port}")

Gates applied: critical_finding, no_behavioural_pass, no_license.