{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_d6z79c6p3wdu","handle":"xhs-auto-mcp","url":"https://wellknown.network/agents/xhs-auto-mcp","links":{"self":"https://wellknown.network/agents/xhs-auto-mcp/record.json","html":"https://wellknown.network/agents/xhs-auto-mcp","markdown":"https://wellknown.network/agents/xhs-auto-mcp/record.md","api":"https://wellknown.network/api/v1/agents/xhs-auto-mcp","status":"https://wellknown.network/api/v1/agents/xhs-auto-mcp/status","claim":"https://wellknown.network/agents/xhs-auto-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/xhs-auto-mcp/claim.json","badge":"https://wellknown.network/agents/xhs-auto-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:xhs-auto-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"xhs-auto-mcp","summary":"小红书自动化工具mcp服务器，提供小红书内容发布及交互功能","description":"# 自动化小红书MCP服务器\n\n这是一个基于MCP的小红书内容创作和管理工具，可以帮助你自动化小红书内容平台的操作，包括搜索笔记、发布笔记、评论等功能。\n\n## 功能特点\n\n- 🔍 搜索小红书笔记内容\n- 📝 发布图文/视频笔记\n- 💬 自动评论笔记\n- 🏠 获取首页推荐内容\n- 🔐 支持账号登录与验证\n\n## 快速开始\n\n### 1. 环境要求\n * node.js\n * python 3.12\n * uv (pip install uv)\n\n### 2. 安装依赖\n```sh\ngit clone https://github.com/fancyboi999/xhs-auto-mcp.git\n\ncd xhs-auto-mcp\nuv venv\nsource .venv/bin/activate\nuv pip install -e .\n```\n\n### 3. 获取小红书的cookie\n[打开网页端小红书](https://www.xiaohongshu.com/explore)\n登录后，获取内容平台的cookie，将cookie配置到MCP服务的 XHS_COOKIE 环境变量中\n![获取cookie教程](docs/get_cookies.png)\n\n### 4. 配置MCP服务\n\n有两种方式可以配置和启动MCP服务，环境变量JSON_PATH 是用于存储创作平台token与cookie，因此请填写绝对路径：\n\n#### 方式一：使用stdio协议（直接连接）\n\n在Claude配置中添加以下内容：\n\n```json\n{\n    \"mcpServers\": {\n        \"xhs-auto-mcp\": {\n            \"command\": \"uvx\",\n            \"args\": [\"xhs-auto-mcp\", \"--transport\", \"stdio\"],\n            \"env\": {\n                \"XHS_COOKIE\": \"xxxx\",\n                \"JSON_PATH\": \"your_token_save_path\"\n            }\n        }\n    }\n}\n```\n\n#### 方式二：使用HTTP协议\n\n1. 启动HTTP服务：\n\n```sh\nenv XHS_COOKIE=xxxx JSON_PATH=your_token_save_path uvx xhs-auto-mcp --transport http --port 8080\n```\n\n2. 在Claude配置中添加以下内容：\n\n```json\n{\n    \"mcpServers\": {\n        \"xhs-auto-mcp\": {\n            \"type\": \"http\",\n            \"url\": \"http://localhost:8080/mcp\"\n        }\n    }\n}\n```\n\n## 工具使用说明\n\n本项目提供了多种工具来操作小红书平台：\n\n![可用工具](docs/available_tools.png)\n\n### 内容平台工具\n- **检查cookie有效性**: 验证当前cookie是否有效\n- **获取首页推荐笔记**: 获取小红书首页推荐内容\n- **搜索笔记**: 根据关键词搜索笔记\n- **获取笔记内容**: 获取指定笔记的详细内容\n- **获取笔记评论**: 获取指定笔记的评论\n- **发表评论**: 对指定笔记发表评论\n\n### 创作平台工具\n- **登录**: 通过手机号和验证码登录小红书创作平台\n- **发布图文笔记**: 创建并发布包含图片的笔记\n- **发布视频笔记**: 创建并发布包含视频的笔记\n\n## 示例视频\n\n查看演示视频了解如何使用本工具：[演示视频](docs/demo.mp4)\n\n## 免责声明\n本项目仅用于学习交流，禁止用于其他用途，任何涉及商业盈利目的均不得使用，否则风险自负。","publisher":{"name":"fancybooi999","url":null},"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:xhs-auto-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"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":"xhs-auto-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:19.564Z","publishedAt":"2025-07-11T08:45:08.889245Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"xhs-auto-mcp","url":"https://pypi.org/project/xhs-auto-mcp/","firstSeenAt":"2026-09-10T16:22:51.542Z","fetchedAt":"2026-09-10T16:22:51.542Z","normalizedAt":"2026-09-10T16:22:51.542Z"}]},"firstSeenAt":"2026-09-10T16:22:51.542Z","updatedAt":"2026-09-10T16:24:19.564Z"}