{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wnzkcwbepwtv","handle":"xhs-mcp-py","url":"https://wellknown.network/agents/xhs-mcp-py","links":{"self":"https://wellknown.network/agents/xhs-mcp-py/record.json","html":"https://wellknown.network/agents/xhs-mcp-py","markdown":"https://wellknown.network/agents/xhs-mcp-py/record.md","api":"https://wellknown.network/api/v1/agents/xhs-mcp-py","status":"https://wellknown.network/api/v1/agents/xhs-mcp-py/status","claim":"https://wellknown.network/agents/xhs-mcp-py/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/xhs-mcp-py/claim.json","badge":"https://wellknown.network/agents/xhs-mcp-py/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:xhs-mcp-py","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"xhs-mcp-py","summary":"小红书 MCP 工具 - 支持登录、发布图文/视频、点赞评论等功能","description":"# xhs-mcp-py\n\n[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n小红书 MCP 工具的 Python 实现，基于 Playwright 浏览器自动化，支持登录、发布、搜索、点赞、收藏、评论等功能。\n\n## 特性\n\n- 🔐 **扫码登录** - 支持二维码扫码登录，自动保存 cookies\n- 📝 **发布内容** - 支持发布图文、视频、文字配图，支持定时发布\n- 🔍 **搜索内容** - 支持关键词搜索（高级筛选能力在 MCP API 中提供）\n- ❤️ **互动功能** - 支持点赞、收藏、评论、回复评论\n- 📊 **数据获取** - 获取首页推荐、笔记详情、用户主页，支持高级评论加载配置\n- 🤖 **MCP 协议** - 支持 MCP 协议，可与 AI 助手集成\n\n## 安装\n\n```bash\npip install xhs-mcp-py\n\n# 首次运行需安装浏览器\nplaywright install chromium\n```\n\n## 快速开始\n\n### 使用流程\n\n1. **首次使用必须先登录**：运行 `xhs-mcp login-browser` 弹出浏览器登录 或 `xhs-mcp login-qrcode --terminal` 在终端中显示二维码登录\n2. **检查登录状态**：运行 `xhs-mcp status`（输出 `✅ 已登录` 或 `❌ 未登录`）\n3. **执行操作**：登录成功后即可使用各种功能\n4. **Cookies 有效期**：约 7-30 天，过期后需重新登录\n\n> 💡 **MCP 使用提示**：让 AI 助手先调用 `check_login_status` 检查登录状态，如果未登录：\n> - 通过 MCP：调用 `login_with_browser`\n> - 或直接在命令行执行：`xhs-mcp login-browser`\n\n## MCP 客户端配置\n\n### Claude Desktop\n\n编辑配置文件 \n* `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）\n* `%APPDATA%\\Claude\\claude_desktop_config.json`（Windows）：\n\n```json\n{\n  \"mcpServers\": {\n    \"xiaohongshu\": {\n      \"command\": \"xhs-mcp\",\n      \"args\": [\"serve\"]\n    }\n  }\n}\n```\n\n如果 `xhs-mcp` 不在系统 PATH 中，使用完整路径：\n\n```json\n{\n  \"mcpServers\": {\n    \"xiaohongshu\": {\n      \"command\": \"/path/to/your/python/bin/xhs-mcp\",\n      \"args\": [\"serve\"]\n    }\n  }\n}\n```\n\n可通过 `which xhs-mcp`（macOS/Linux）或 `where xhs-mcp`（Windows）查看完整路径。\n\n配置完成后重启 Claude Desktop。\n\n### Claude Code\n\n```bash\n# 添加 MCP 服务\nclaude mcp add xhs-mcp -- xhs-mcp serve\n\n# 查看已添加的 MCP\nclaude mcp list\n\n# 移除 MCP 服务\nclaude mcp remove xhs-mcp\n```\n\n### Cursor\n\n在 Cursor 设置中添加 MCP 配置：\n\n1. 打开 Cursor Settings → Features → MCP Servers\n2. 点击 \"Add Server\"\n3. 填写：\n   - Name: `xhs-mcp`\n   - Command: `xhs-mcp serve`\n\n### 其他 MCP 客户端\n\n任何支持 MCP 协议的客户端都可以使用，启动命令为：\n\n```bash\nxhs-mcp serve\n```\n\n## 发布\n\n### 图文\n\n```\n图：~/Downloads/vc.png\n\n文字标题：Vibe Coding 真的心累💔\n\n文字正文内容：强如 Opus，也只是傻乎乎地解决当下的指令...\n…","publisher":null,"homepage":"https://github.com/luweizheng/xhs-mcp-py","repository":"https://github.com/luweizheng/xhs-mcp-py","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["automation","mcp","playwright","xiaohongshu"],"pricing":null,"endpoints":[{"url":"pypi:xhs-mcp-py","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":"infra.browser-automation","name":"Browser Automation","confidence":1,"provenance":"declared"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"}],"categories":["dev","infra"],"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-mcp-py","registry":"pypi","observedAt":"2026-09-10T16:24:19.708Z","publishedAt":"2026-02-27T15:35:57.896747Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"xhs-mcp-py","url":"https://pypi.org/project/xhs-mcp-py/","firstSeenAt":"2026-09-10T16:22:53.229Z","fetchedAt":"2026-09-10T16:22:53.229Z","normalizedAt":"2026-09-10T16:22:53.229Z"}]},"firstSeenAt":"2026-09-10T16:22:53.229Z","updatedAt":"2026-09-10T16:24:19.708Z"}