# TikHub API Helper

TikHub API 助手是一个 Claude Code Agent Skill，用于帮助用户搜索、发现和调用 TikHub API。TikHub 提供了多平台社交媒体数据 API，支持抖音、TikTok、小红书、Instagram、YouTube、Twitter、Reddit 等平台。

## 简介

TikHub 是一个多平台社交媒体数据 API 服务，提供 RESTful 接口来获取各大社交平台的数据。本项目是一个 Claude Code Agent Skill，可以让你在使用 Claude Code 时轻松调用 TikHub API。

### 支持的平台

| 平台 | API 标签 | 端点数量 | |------|----------|----------| | TikTok Web | `TikTok-Web-API` | 58 | | TikTok App | `TikTok-App-V3-API` | 76 | | 抖音 Web | `Douyin-Web-API` | 76 | | 抖音 App | `Douyin-App-V3-API` | 45 | | 小红书 Web | `Xiaohongshu-Web-API` | 26 | | Instagram | `Instagram-V2-API` | 26 | | YouTube | `YouTube-Web-API` | 16 | | Twitter | `Twitter-Web-API` | 13 | | Reddit | `Reddit-APP-API` | 23 | | Bilibili | `Bilibili-Web-API` | 24 | | 微博 | `Weibo-Web-V2-API` | 33 | | 知乎 | `Zhihu-Web-API` | 32 |

## 功能特性

- **API 搜索** - 通过关键词、标签或操作 ID 搜索 TikHub API - **API 调用** - 直接通过命令行调用 TikHub API - **多平台支持** - 支持抖音、TikTok、小红书等 12+ 平台 - **中英文支持** - 支持中英文关键词搜索 - **自动鉴权** - 内置开发环境 API Token

## 安装

### 1. 克隆仓库

```bash git clone https://github.com/your-username/tikhub_api_skill.git cd tikhub_api_skill ```

### 2. 确保项目结构正确

确保 `.claude/skills/tikhub-api-helper/` 目录包含以下文件：

``` .claude/skills/tikhub-api-helper/ ├── SKILL.md # Skill 定义文件 ├── openapi.json # OpenAPI 规范 ├── api_searcher.py # API 搜索工具 └── api_client.py # API 客户端 ```

### 3. 获取 API Token（可选）

代码中已内置开发环境用的 API Token。如需使用自己的 Token：

1. 访问 [TikHub User](https://www.tikhub.io) 登录 2. 点击左侧 API Keys 生成你的 API Token 3. 设置变量：

```bash 在 api_client.py 23行，配置 DEFAULT_TOKEN = "你的 API Token" ```

## 使用方法

### 通过 Claude Code 使用

当你在 Claude Code 中询问关于 TikHub API 的问题时，该 Skill 会自动激活：

``` # 示例对话 你: "调研各外国平台讨论 deepseek的帖子" Claude: [自动调用 tikhub-api-helper Skill 搜索相关 API] ```

## API 基础信息

### 请求地址

- **中国用户**: `https://api.tikhub.dev` (绕过 GFW) - **国际用户**: `https://api.tikhub.io`

### 鉴权方式

所有需要在请求头中携带 API Token：

```json { "Authorization": "Bearer Your_API_Token" } ```

### 请求限制

- **QPS**: 每个端点每秒 10 次请求 - **超时**: