toutiao-prolisted
Install: claude install-skill XieWxx/maxhub-api-skills
> ⛔ **合规硬前置指令(HARD PREREQUISITE — Agent 不得跳过)**
>
> 在执行任何 API 调用、读取 reference 文件、匹配 recipe 之前,Agent **必须**先完成 §基础使用 Step 0 的合规检查。
>
> - **禁止**绕过 Step 0 直接进入 Step 1(检查 API Key)或更后续步骤
> - **禁止**以"用户已多次使用"为由跳过首次闸门或风险检测
> - **禁止**将 Step 0 的合规检查视为可选步骤
> - 若 Step 0 未通过(首次确认缺失、用户拒绝、风险检测未确认),**立即停止**,不执行任何后续操作
>
> 违反此指令将导致法律合规风险,Agent 必须严格执行。
# 今日头条 数据助手
## 1. 简介
今日头条(Toutiao)内容数据查询与资讯分析 skill,通过 MaxHub API 查询文章/视频详情、评论、用户/媒体号、搜索、热榜和推荐内容。适合资讯选题、舆情监控、内容互动分析、媒体号画像和热点跟踪。默认 read-only;agent 应按 recipes 匹配文章、评论、搜索、热榜等意图,并用字段流字典传递 item_id/group_id/user_id 等参数。所有请求发送到 https://www.aconfig.cn。
## 2. 详细功能
### 文章与视频双形态
- 拉取头条文章详情,包含完整正文、配图、作者与发布时间
- 拉取头条视频详情,获取视频元数据、封面与互动统计
- 同一篇内容支持文章与视频两种调用入口,覆盖图文与视频双场景
- 适合批量爬取爆款内容,构建头条赛道的内容数据库
### 评论链路
- 拉取一篇头条文章或视频下的一级评论列表
- 支持游标翻页,可持续翻页直至覆盖全部评论
- 还原读者的真实反馈与争议焦点,辅助舆情研判
### 用户全景画像
- 读取头条号作者的资料、签名、认证身份与粉丝量
- 通过用户主页 URL 反查用户唯一标识,打通"链接 → 资料"的解析链路
- 适合 MCN 与品牌方批量梳理头条号矩阵与作者画像
### App 与 Web 双端覆盖
- 同时支持 App 端与 Web 端两种数据入口,按场景灵活选择
- App 端与 Web 端可双向校对同一篇内容的元数据,提升采集可靠性
- 跨端字段互补,规避单端数据缺失或字段空洞的风险
### 账号余额查询
- 查询 MaxHub API 账号剩余额度,支持 `x-api-key` 或 `Authorization: Bearer` 两种认证方式
- 频率限制:最快每 3 秒调用一次
- 接口路径:`GET /api/maxhub/balance`
## ⚖️ 法律免责与合规声明
> **使用本 skill 即表示您确认已阅读并同意以下条款:**
>
> 1. **数据来源**:本 skill 通过第三方数据服务(MaxHub API)获取 今日头条(Toutiao) 数据,该服务**未获得 今日头条(Toutiao) 官方授权**。本项目对数据获取的合法性不作任何保证。
> 2. **合规责任**:使用方需**自行确保**符合所在地区的数据保护法律(《个人信息保护法》/ GDPR / CCPA 等)及 今日头条(Toutiao) 服务条款(ToS)。因使用本 skill 产生的任何法律后果由使用方自行承担。
> 3. **禁止用途**:严禁将本 skill 用于违反法律的行为,包括但不限于:侵犯个人信息