{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wp9zmrk3xhsb","handle":"redfox-mcp-2","url":"https://wellknown.network/agents/redfox-mcp-2","links":{"self":"https://wellknown.network/agents/redfox-mcp-2/record.json","html":"https://wellknown.network/agents/redfox-mcp-2","markdown":"https://wellknown.network/agents/redfox-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/redfox-mcp-2","status":"https://wellknown.network/api/v1/agents/redfox-mcp-2/status","claim":"https://wellknown.network/agents/redfox-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/redfox-mcp-2/claim.json","badge":"https://wellknown.network/agents/redfox-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/redfox-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/redfox-mcp-2/tools"},"ard":{"identifier":"urn:air::server:redfox-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"redfox-mcp","summary":"RedFoxHub MCP server (all-in-one): 13 platforms — Douyin/Xiaohongshu/WeChat/Bilibili/Toutiao/TikTok/Kuaishou/Instagram/X/YouTube/WeChat Channels + Auto (懂车帝/汽车之家/易车) + AI (search/image/video) + Tools (download/upload)","description":"# redfox-mcp\n\nRedFoxHub MCP Server（全量聚合版）— 将 6 大内容平台数据 API 与 AI 搜索 / 生成能力封装为 69 个 MCP 工具，适用于 dsh、Claude Code、Cursor 等任意 MCP 客户端。\n\n本包为聚合包，组合以下 8 个独立平台包（也可按需单独安装）：\n\n| 独立包 | 工具数 | 说明 |\n|---|---|---|\n| `redfox-douyin-mcp` | 16 | 抖音作品/账号搜索（优质库+广域库）、账号信息、作品列表与详情、AI 作品搜索、每日热门/点赞飙升榜、热门账号推荐、视频提文案 |\n| `redfox-xiaohongshu-mcp` | 15 | 小红书笔记/博主搜索、账号信息、笔记详情、账号作品列表、AI 笔记搜索、每日/七日爆款榜、热门账号推荐、爆款洞察、黑马爆文榜、评论采集、视频提文案 |\n| `redfox-wechat-mcp` | 16 | 公众号文章/账号搜索（优质库+广域库）、账号信息、文章列表与全文详情、AI 文章搜索、10W+/原创爆款/综合实力/阅读增长榜单 |\n| `redfox-bilibili-mcp` | 5 | B 站视频/UP 主搜索、UP 主信息与视频、视频详情 |\n| `redfox-toutiao-mcp` | 2 | 今日头条内容搜索与作品详情（实时） |\n| `redfox-tiktok-mcp` | 1 | TikTok 账号搜索 |\n| `redfox-ai-search-mcp` | 6 | Kimi / 豆包 / Deepseek 联网 AI 搜索（自动轮询 + 结果补查） |\n| `redfox-ai-gen-mcp` | 8 | GPT 图片 / 豆包图片 Pro / Lite / 豆包视频生成（自动轮询 + 结果补查） |\n\n异步工具（AI 搜索 / 生成）内部自动轮询：提交 → 等待 → 返回完整结果，无需手动处理 taskId。若等待超过 `timeout_seconds`（默认 240 秒、视频 480 秒），返回 `taskId`，可用对应的 result 工具补查。\n\n## 认证\n\n1. 前往 <https://redfox.hk/settings/api-keys?source=mcp> 获取 API Key\n2. 设置环境变量：\n\n```bash\nexport REDFOX_API_KEY=\"YOUR_API_KEY\"\n```\n\n未配置 key 时，每个工具都会返回结构化的获取引导。\n\n## 安装与运行（本地 stdio）\n\n需要 Python ≥ 3.10，推荐使用 [uv](https://docs.astral.sh/uv/)：\n\n```bash\nuvx redfox-mcp\n```\n\n或：\n\n```bash\npip install redfox-mcp\nredfox-mcp\n```\n\n## 客户端配置\n\nClaude Code：\n\n```bash\nclaude mcp add redfox --env REDFOX_API_KEY=YOUR_API_KEY -- uvx redfox-mcp\n```\n\nCursor / 其他 MCP 客户端：\n\n```json\n{\n  \"mcpServers\": {\n    \"redfox\": {\n      \"command\": \"uvx\",\n      \"args\": [\"redfox-mcp\"],\n      \"env\": { \"REDFOX_API_KEY\": \"YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n## 远程 HTTP 模式（多租户）\n\n适用于 MCP 市场与托管场景，每个用户携带自己的 API Key：\n\n```bash\nredfox-mcp --transport http --host 0.0.0.0 --port 8000\n# 或环境变量：REDFOX_MCP_TRANSPORT=http REDFOX_MCP_HOST=0.0.0.0 REDFOX_MCP_PORT=8000\n```\n\n- MCP 端点：`http://<host>:8000/mcp`（Streamable HTTP）；健康检查：`GET /health`\n- 每个请求通过请求头 `REDFOX_API_KEY: <key>`（或 `Authorization: Bearer <key>`）携带自己的 key，按 key 建独立客户端缓存，额度互不共享\n\n客户端配置（远程 URL + 请求头）：\n\n```json\n{\n  \"mcpServers\": {\n    \"redfox\": {\n      \"url…","publisher":null,"homepage":"https://github.com/redfox-data/redfox-mcp","repository":"https://github.com/redfox-data/redfox-mcp","version":"0.4.3","license":null,"protocols":["mcp"],"tags":["autohome","bilibili","dongchedi","douyin","instagram","kuaishou","mcp","redfox","tiktok","toutiao","twitter","wechat","xiaohongshu","yiche","youtube"],"pricing":null,"endpoints":[{"url":"pypi:redfox-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"content.social","name":"Social Media","confidence":1,"provenance":"declared"}],"categories":["content"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"redfox-mcp","registry":"pypi","observedAt":"2026-11-03T23:22:54.801Z","publishedAt":"2026-09-15T01:27:30.009316Z","latestVersion":"0.4.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"redfox-mcp","url":"https://pypi.org/project/redfox-mcp/","firstSeenAt":"2026-09-10T11:26:25.690Z","fetchedAt":"2026-11-03T23:21:32.318Z","normalizedAt":"2026-11-03T23:21:32.318Z"}]},"firstSeenAt":"2026-09-10T11:26:25.690Z","updatedAt":"2026-11-03T23:22:54.801Z"}