redfox-mcp
Officialredfox-mcp
RedFoxHub MCP 服务器——将6大主流内容平台的数据API以及AI搜索/生成能力转化为40个MCP工具,可直接用于任何MCP客户端,如dsh、Claude Code或Cursor。
工具(40个)
类别 | 工具 | 说明 |
抖音 |
| 作品搜索、账号搜索、账号信息、作品列表、作品详情、AI作品流 |
小红书 |
| 笔记搜索、创作者搜索、账号信息、笔记详情、AI笔记流 |
微信公众号 |
| 文章搜索(含全文详情)、账号搜索、文章列表、AI文章流 |
B站 |
| 视频搜索、UP主搜索/信息/视频、视频详情 |
头条 |
| 内容搜索、作品详情(实时) |
TikTok |
| 账号搜索 |
AI搜索 |
| 一次调用提交查询并等待完整回答 |
AI生成 |
| 文生图/图生图/图片集/文生视频,一次调用提交并等待 |
任务跟进 |
| 当异步工具超时时返回 |
异步工具(AI搜索/生成)内部轮询:提交→等待→返回完整结果,无需手动处理taskId。如果等待超过timeout_seconds(默认240秒,视频为480秒),则返回taskId供对应的结果工具使用。
Related MCP server: xiaohongshu-mcp
认证
所有API都需要RedFoxHub API密钥:
export REDFOX_API_KEY="YOUR_API_KEY"没有密钥时,每个工具都会返回一条结构化消息,说明如何获取密钥。
安装与运行
需要Python ≥ 3.10。推荐通过uv安装:
uvx redfox-mcp或:
pip install redfox-mcp
redfox-mcp服务器通过stdio传输运行。
客户端配置
dsh (DeepSeek Harness)
安装官方插件包redfox-community-dsh——它会自动注册此MCP服务器,将工具暴露为mcp__redfox__*:
dsh plugin --profile web add -w github:redfox-data/redfox-community-dshClaude Code
claude mcp add redfox --env REDFOX_API_KEY=YOUR_API_KEY -- uvx redfox-mcpCursor / 其他MCP客户端
添加到您的MCP配置中:
{
"mcpServers": {
"redfox": {
"command": "uvx",
"args": ["redfox-mcp"],
"env": { "REDFOX_API_KEY": "YOUR_API_KEY" }
}
}
}底层实现
基于官方SDKredfox-python-sdk构建。API文档:https://redfox.hk/?source=mcp。
许可证
MIT
Available Tools
40 toolsai_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
Scored across 40 tools
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.
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.
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.
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
Related MCP Connectors
Public data from 20+ platforms, including Douyin, Xiaohongshu, Weibo and TikTok, as structured JSON
660+ data tools for agents: TikTok, Douyin, Instagram, YouTube, X, weather, GitHub. Pay per call.
Social data for AI agents: TikTok, RedNote, Douyin, WeChat, X, YouTube and more. Pay per call.
TikTok research for AI agents. Ask ChatGPT, Claude, Cursor, Codex or any MCP client what people search, watch, say and buy on TikTok, and get real numbers back. 34 tools: weekly TikTok search volume and 7-day trends, content gaps, videos, creators, comments and caption transcripts, hashtags and sounds, TikTok Shop sales estimates for products, shops, creators, videos and LIVE streams, TikTok’s Top Ads library with CTR and retention, places, and a fair comment-giveaway picker. 17 markets. Built for marketers, agencies, TikTok Shop sellers and creators. Sign in with OAuth or an API key; 50 free credits, no card.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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-
- AlicenseAqualityDmaintenanceEnables AI assistants to search, browse, and publish notes on Xiaohongshu (Little Red Book) via MCP tools.8AGPL 3.0
- AlicenseCqualityCmaintenanceProvides 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.8891 npm1MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to collect and localize content from WeChat, Douyin, Kuaishou, Xiaohongshu, and Bilibili, with 47 MCP tools for fetching articles, parsing media, and managing a unified local content library.1-