Skip to main content
Glama
redfox-mcp

redfox-mcp

Official
by redfox-data

redfox-mcp

RedFoxHub MCP monorepo — the data APIs of 11 content platforms plus auto vertical (3 brands), AI search / generation and download/upload tools, exposed as 134 MCP tools split into 15 independent per-platform MCP servers, ready for any MCP client such as dsh, Claude Code or Cursor.

Every package supports both local stdio (single-user, REDFOX_API_KEY env var) and remote HTTP (multi-tenant, per-request API key header), and ships its own Dockerfile for independent deployment.

Packages

Package

Tools

stdio command

Docker service / port

redfox-mcp (all-in-one)

134

uvx redfox-mcp

all → 8000

redfox-douyin-mcp

16

uvx redfox-douyin-mcp

douyin → 8001

redfox-xiaohongshu-mcp

15

uvx redfox-xiaohongshu-mcp

xiaohongshu → 8002

redfox-wechat-mcp

16

uvx redfox-wechat-mcp

wechat → 8003

redfox-bilibili-mcp

8

uvx redfox-bilibili-mcp

bilibili → 8004

redfox-toutiao-mcp

5

uvx redfox-toutiao-mcp

toutiao → 8005

redfox-tiktok-mcp

4

uvx redfox-tiktok-mcp

tiktok → 8006

redfox-ai-search-mcp

12

uvx redfox-ai-search-mcp

ai-search → 8007

redfox-ai-gen-mcp

8

uvx redfox-ai-gen-mcp

ai-gen → 8008

redfox-kuaishou-mcp

6

uvx redfox-kuaishou-mcp

kuaishou → 8009

redfox-instagram-mcp

4

uvx redfox-instagram-mcp

instagram → 8010

redfox-twitter-mcp

4

uvx redfox-twitter-mcp

twitter → 8011

redfox-youtube-mcp

4

uvx redfox-youtube-mcp

youtube → 8012

redfox-wechat-channels-mcp

7

uvx redfox-wechat-channels-mcp

wechat-channels → 8013

redfox-auto-mcp

13

uvx redfox-auto-mcp

auto → 8014

redfox-tools-mcp

12

uvx redfox-tools-mcp

tools → 8015

redfox-mcp-core

—

shared runtime (not user-facing)

—

Async tools (AI search / generation) poll internally: submit → wait → return the full result. If the wait exceeds timeout_seconds (default 240s, 480s for video), a taskId is returned for the matching *_result tool.

Related MCP server: xiaohongshu-mcp

Authentication

All APIs require a RedFoxHub API key:

  1. Get one at https://redfox.hk/settings/api-keys/?source=mcp

  2. Set the environment variable:

export REDFOX_API_KEY="YOUR_API_KEY"

Without a key, every tool returns a structured message explaining how to obtain one.

Quick Start (stdio)

Python ≥ 3.10 required. Pick only the platforms you need — e.g. Douyin only:

uvx redfox-douyin-mcp

or the all-in-one bundle with all 134 tools:

uvx redfox-mcp

Client configuration (Cursor / other MCP clients):

{
  "mcpServers": {
    "redfox-douyin": {
      "command": "uvx",
      "args": ["redfox-douyin-mcp"],
      "env": { "REDFOX_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code:

claude mcp add redfox-douyin --env REDFOX_API_KEY=YOUR_API_KEY -- uvx redfox-douyin-mcp

Remote HTTP Mode (multi-tenant)

Each server can run as a remote HTTP service where every user brings their own API key:

redfox-douyin-mcp --transport http --host 0.0.0.0 --port 8000
# or via env vars: REDFOX_MCP_TRANSPORT=http REDFOX_MCP_HOST=0.0.0.0 REDFOX_MCP_PORT=8000
  • MCP endpoint: http://<host>:8000/mcp (Streamable HTTP); health check: GET /health

  • Each request carries its own key via header REDFOX_API_KEY: <key> (or Authorization: Bearer <key>). A dedicated client is created and cached per key — quotas are never shared across users.

Client-side config (remote URL + header):

{
  "mcpServers": {
    "redfox-douyin": {
      "url": "http://<host>:8000/mcp",
      "headers": { "REDFOX_API_KEY": "ak_your_key" }
    }
  }
}

Docker Deployment

Each package directory is self-contained with its own Dockerfile and can be deployed independently:

cd packages/redfox-douyin-mcp
docker build -t redfox-douyin-mcp .
docker run -d -p 8001:8000 redfox-douyin-mcp

A root-level docker-compose.yml is provided for convenience — every service is independent and can be started/stopped on its own:

docker compose up -d douyin        # one platform only
docker compose up -d               # all 16 services, ports 8000-8015

Images never embed API keys; callers pass their own key via request header.

Development

This repo is a uv workspace. After cloning:

uv sync                            # installs all packages from source
uv run redfox-douyin-mcp --help    # run any server from source

Publishing

Packages are published to PyPI individually, in dependency order:

cd packages/redfox-mcp-core && uv build && uv publish        # 1. core first
cd packages/redfox-douyin-mcp && uv build && uv publish      # 2. platform packages
# ... repeat for the other 13 platform packages ...
cd packages/redfox-mcp && uv build && uv publish             # 3. all-in-one last

Under the Hood

Built on the official SDK redfox-python-sdk. API docs: https://redfox.hk/?source=mcp.

License

MIT

Available Tools

40 tools
ai_search_deepseekA

Deepseek 联网 AI 搜索,提交后自动等待并返回完整结果。 inquiry_text 为搜索提问文本;超时未完成时返回 taskId,可用 ai_search_deepseek_result 再查。

Inputs: inquiry_text (required), timeout_seconds. Returns: object

ai_search_deepseek_resultA

查询 Deepseek 搜索任务结果。仅在 ai_search_deepseek 超时返回 taskId 后使用。

Inputs: task_id (required). Returns: object

ai_search_doubaoA

豆包联网 AI 搜索,提交后自动等待并返回完整结果。 inquiry_text 为搜索提问文本;超时未完成时返回 taskId,可用 ai_search_doubao_result 再查。

Inputs: inquiry_text (required), timeout_seconds. Returns: object

ai_search_doubao_resultA

查询豆包搜索任务结果。仅在 ai_search_doubao 超时返回 taskId 后使用。

Inputs: task_id (required). Returns: object

ai_search_kimiA

Kimi 联网 AI 搜索,提交后自动等待并返回完整结果(含 content/webPages)。 inquiry_text 为搜索提问文本;超时未完成时返回 taskId,可用 ai_search_kimi_result 再查。

Inputs: inquiry_text (required), timeout_seconds. Returns: object

ai_search_kimi_resultA

查询 Kimi 搜索任务结果。仅在 ai_search_kimi 超时返回 taskId 后使用。

Inputs: task_id (required). Returns: object

bilibili_get_accountB

获取 B 站 UP 主信息(优质库)。mid 为 B 站用户唯一 ID。

Inputs: mid (required). Returns: object

bilibili_get_user_worksB

获取 B 站 UP 主视频列表(优质库)。mid 与 account_url(主页链接)至少传一个; order:time=发布时间 / play=播放数 / like=点赞数。

Inputs: mid, page, order, page_size, +1 more. Returns: object

bilibili_get_workA

获取 B 站视频详情(优质库)。bvid 与 work_url 至少传一个, work_url 支持 bilibili.com/video/BVxxx 或 b23.tv 短链。

Inputs: bvid, work_url. Returns: object

bilibili_search_articlesA

搜索 B 站视频(优质库)。keyword 必填;page 从 1 开始;page_size 默认 10、最大 50; order:time=发布时间 / play=播放数 / like=点赞数 / comment=评论数 / favorite=收藏数。

Inputs: keyword (required), page, order, page_size. Returns: object

bilibili_search_usersB

搜索 B 站 UP 主(优质库)。keyword 必填; order:follower=粉丝数 / like=获赞数,默认按相关性。

Inputs: keyword (required), page, order, page_size. Returns: object

doubao_image_lite_generateA

豆包 Seedream 5.0 Lite 图片生成,支持组图,提交后自动等待结果。 size 支持 "2K"/"3K"/"4K" 或像素值;sequential 设为 "auto" 时生成组图, max_images 控制组图数量(1~10)。超时返回 taskId,可用 doubao_image_lite_result 再查。

Inputs: prompt (required), size, image, watermark, +7 more. Returns: object

doubao_image_lite_resultA

查询 Seedream 5.0 Lite 任务结果。仅在 doubao_image_lite_generate 超时返回 taskId 后使用。

Inputs: task_id (required). Returns: object

doubao_image_pro_generateB

豆包 Seedream 5.0 Pro 图片生成,提交后自动等待结果。 size 支持 "1K"/"2K" 或像素值如 "2048x2048";image 为图生图输入(URL 或 Base64, 可传单个字符串或字符串列表);optimize_prompt 开启提示词优化(standard/fast)。 超时返回 taskId,可用 doubao_image_pro_result 再查。

Inputs: prompt (required), size, image, watermark, +5 more. Returns: object

doubao_image_pro_resultA

查询 Seedream 5.0 Pro 任务结果。仅在 doubao_image_pro_generate 超时返回 taskId 后使用。

Inputs: task_id (required). Returns: object

doubao_video_generateA

豆包 Seedance 2.0 视频生成,提交后自动等待结果。 content 为输入内容列表(必填),每项形如: {"type": "text", "text": "描述文字"}; {"type": "image_url", "imageUrl": "图片URL", "imageRole": "first_frame/reference_image"}; {"type": "video_url", "videoUrl": "视频URL", "videoRole": "reference_video"}; {"type": "audio_url", "audioUrl": "音频URL", "audioRole": "reference_audio"}。 resolution:480p/720p/1080p;ratio:adaptive/16:9/4:3/1:1/3:4/9:16/21:9; duration 秒数 [4,15] 或 -1 智能。超时返回 taskId,可用 doubao_video_result 再查。

Inputs: content (required), seed, model, ratio, +6 more. Returns: object

doubao_video_resultA

查询豆包视频生成任务结果。仅在 doubao_video_generate 超时返回 taskId 后使用。

Inputs: task_id (required). Returns: object

douyin_get_userA

获取抖音账号信息(优质库)。account_id 为抖音账号 ID, 支持 unique_id、short_id、uid 任一匹配。

Inputs: account_id (required). Returns: object

douyin_get_user_worksA

获取抖音账号作品列表(优质库)。account_id(抖音号)/ author_url(主页链接)/ sec_user_id 至少传一个;offset 每页 +20;sort_type:0=默认,2=最新,4=最热。

Inputs: offset, sort_type, account_id, author_url, +1 more. Returns: object

douyin_get_workA

获取抖音作品详情(优质库)。work_id 与 work_url(作品链接)至少传一个, 返回互动数据、作者信息等。

Inputs: work_id, work_url. Returns: object

douyin_search_ai_articlesB

搜索抖音 AI 相关作品(优质库)。keyword 必填; start_time/end_time 格式如 "2026-06-01 00:00:00"。

Inputs: keyword (required), end_time, page_num, page_size, +1 more. Returns: object

douyin_search_articlesA

搜索抖音作品(优质库)。keyword 必填;offset 分页偏移从 0 开始、每次 +20; sort_type 排序方式,如 "default"。返回含 total/hasMore/list。

Inputs: keyword (required), offset, sort_type. Returns: object

douyin_search_usersC

搜索抖音账号(优质库)。keyword 必填;offset 分页偏移从 0 开始。

Inputs: keyword (required), offset, sort_type. Returns: object

gpt_image_generateB

GPT 图片生成(gpt-image-2),提交后自动等待并返回 imagePaths。 operation:generate=文生图 / edit=图生图(edit 时 images 必填, 形如 [{"url": "https://..."}],input_fidelity 支持 high/low); quality:low/medium/high/auto;background:transparent/opaque/auto; output_format:png/jpeg/webp。超时返回 taskId,可用 gpt_image_result 再查。

Inputs: prompt (required), n, size, images, +8 more. Returns: object

gpt_image_resultA

查询 GPT 图片生成任务结果(含 status/imagePaths/failReason)。 仅在 gpt_image_generate 超时返回 taskId 后使用。

Inputs: task_id (required). Returns: object

tiktok_search_usersB

搜索 TikTok 账号。keyword 必填;cursor 翻页游标第一页为 0、每页 +10; rid 为上一页数据返回的 rid,翻页时传入。返回含 cursor/hasMore/userList。

Inputs: keyword (required), rid, cursor. Returns: object

toutiao_get_workA

获取今日头条作品详情(实时)。opus_id 为作品 ID。

Inputs: opus_id (required). Returns: object

toutiao_search_worksB

搜索今日头条内容(实时)。keyword 必填;offset 翻页偏移从 0 开始、每页 +1。

Inputs: keyword (required), offset. Returns: object

wechat_get_accountB

获取公众号账号信息(优质库)。account 为公众号微信号(必填), account_name 为公众号名称(可选)。

Inputs: account (required), account_name. Returns: object

wechat_get_article_detailC

根据文章链接获取公众号文章详情,支持全文内容(优质库)。 url 形如 https://mp.weixin.qq.com/s/...

Inputs: url (required). Returns: object

wechat_get_user_worksC

获取公众号文章列表(优质库)。account 为公众号微信号(必填); sort_type:_0=默认,_2=最新,_4=最热;publish_time_start/end 格式如 "2026-07-01"。

Inputs: account (required), offset, sort_type, account_name, +2 more. Returns: object

wechat_get_workC

根据作品 UUID 获取公众号文章元数据(优质库)。

Inputs: work_uuid (required). Returns: object

wechat_search_ai_articlesB

搜索公众号 AI 创作相关文章(优质库)。keyword 必填; start_time/end_time 格式如 "2026-06-01 00:00:00"。

Inputs: keyword (required), end_time, page_num, page_size, +1 more. Returns: object

wechat_search_articlesB

搜索公众号文章(优质库)。keyword 必填;offset 从 0 开始、每页 +20。

Inputs: keyword (required), offset, sort_type. Returns: object

wechat_search_usersA

搜索公众号账号(优质库)。keyword 必填;sort_type:_0=默认,_2=最新,_4=最热。

Inputs: keyword (required), offset, sort_type. Returns: object

xiaohongshu_get_accountA

获取小红书账号信息(优质库)。account_id 为小红书号(必填),user_id 可选。

Inputs: account_id (required), user_id. Returns: object

xiaohongshu_get_workA

获取小红书笔记详情(优质库)。work_id 与 work_link(笔记链接)至少传一个。

Inputs: work_id, work_link. Returns: object

xiaohongshu_search_ai_articlesB

搜索小红书 AI 创作相关笔记(优质库)。keyword 必填; start_time/end_time 格式如 "2026-06-01 00:00:00";source 为来源平台(可选)。

Inputs: keyword (required), source, end_time, page_num, +2 more. Returns: object

xiaohongshu_search_articlesB

搜索小红书笔记(优质库)。keyword 必填;offset 分页偏移。

Inputs: keyword (required), offset, sort_type. Returns: object

xiaohongshu_search_usersC

搜索小红书博主账号(优质库)。keyword 必填;offset 分页偏移。

Inputs: keyword (required), offset, sort_type. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 40 tools

    Disambiguation5/5

    Each tool has a clear and distinct purpose, organized by platform (Douyin, Xiaohongshu, etc.) and action (search, get user, get work, generate). Even within similar functions across platforms, the names and descriptions make them unambiguous. The result-query tools are explicitly paired with their generation counterparts.

    Naming Consistency5/5

    All tool names follow a consistent pattern: platform_or_service_action, using snake_case (e.g., douyin_search_articles, ai_search_kimi, doubao_image_pro_generate). The naming is predictable and intuitive, with no mixing of conventions or cryptic abbreviations.

    Tool Count4/5

    At 40 tools, the count is high, but it is justified by the server's broad scope covering multiple social media platforms and AI generation services. Each tool earns its place, though the sheer number could be slightly overwhelming. Still, it remains well-scoped for its intended use case.

    Completeness5/5

    For the server's stated purpose—searching and retrieving content from various social media platforms plus generating images/videos and performing AI searches—the tool surface is comprehensive. Each platform includes search, user info, works list, and detail retrieval. AI generation and search workflows are fully covered with both submission and result query tools.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to crawl and extract data from Chinese social media platforms like Bilibili, Xiaohongshu, and Douyin. Provides search, content detail retrieval, and creator information tools with persistent browser sessions and QR code login support.
      80
      -
    • A
      license
      C
      quality
      C
      maintenance
      Provides a unified MCP interface to 91 RedFox agent tools for social media analytics, content creation, and video downloading across platforms like Douyin, Xiaohongshu, WeChat, and Bilibili. Works with any MCP-compatible client via stdio or remote deployment, requiring only a RedFox API key.
      88
      91 npm
      1
      MIT