jobson-xhs-mcp


Namejobson-xhs-mcp JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
Summary小红书MCP服务器 - 提供小红书API功能的MCP工具
upload_time2025-08-28 06:43:38
maintainerNone
docs_urlNone
authorNone
requires_python>=3.12
licenseMIT
keywords api mcp server xiaohongshu
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 小红书MCP服务
[![smithery badge](https://smithery.ai/badge/@jobsonlook/xhs-mcp)](https://smithery.ai/server/@jobsonlook/xhs-mcp)
## 特点
- [x] 采用js逆向出x-s,x-t,直接请求http接口,无须笨重的playwright
- [x] 搜索笔记
- [x] 获取笔记内容
- [x] 获取笔记的评论
- [x] 发表评论

![特性](https://raw.githubusercontent.com/jobsonlook/xhs-mcp/master/docs/feature.png)

## 快速开始

### 1. 环境
 * node
 * python 3.12
 * uv (pip install uv)

### 2. 安装依赖
```sh

git clone git@github.com:jobsonlook/xhs-mcp.git

cd xhs-mcp
uv sync 

```

### 3. 获取小红书的cookie
[打开web小红书](https://www.xiaohongshu.com/explore)
登录后,获取cookie,将cookie配置到第4步的 XHS_COOKIE 环境变量中
![cookie](https://raw.githubusercontent.com/jobsonlook/xhs-mcp/master/docs/cookie.png)

### 4. 配置mcp server

```json
{
    "mcpServers": {
        "xhs-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/xxx/xhs-mcp",
                "run",
                "main.py"
            ],
            "env": {
                "XHS_COOKIE": "xxxx"
            }
        }
    }
}
```

## 免责声明
本项目仅用于学习交流,禁止用于其他用途,任何涉及商业盈利目的均不得使用,否则风险自负。


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "jobson-xhs-mcp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": null,
    "keywords": "api, mcp, server, xiaohongshu",
    "author": null,
    "author_email": "Your Name <your.email@example.com>",
    "download_url": "https://files.pythonhosted.org/packages/50/59/a476fb7e5cf8df34c122155d8b86cd9c06911a840c61bd9cf7d324ad8876/jobson_xhs_mcp-0.1.1.tar.gz",
    "platform": null,
    "description": "# \u5c0f\u7ea2\u4e66MCP\u670d\u52a1\n[![smithery badge](https://smithery.ai/badge/@jobsonlook/xhs-mcp)](https://smithery.ai/server/@jobsonlook/xhs-mcp)\n## \u7279\u70b9\n- [x] \u91c7\u7528js\u9006\u5411\u51fax-s,x-t,\u76f4\u63a5\u8bf7\u6c42http\u63a5\u53e3,\u65e0\u987b\u7b28\u91cd\u7684playwright\n- [x] \u641c\u7d22\u7b14\u8bb0\n- [x] \u83b7\u53d6\u7b14\u8bb0\u5185\u5bb9\n- [x] \u83b7\u53d6\u7b14\u8bb0\u7684\u8bc4\u8bba\n- [x] \u53d1\u8868\u8bc4\u8bba\n\n![\u7279\u6027](https://raw.githubusercontent.com/jobsonlook/xhs-mcp/master/docs/feature.png)\n\n## \u5feb\u901f\u5f00\u59cb\n\n### 1. \u73af\u5883\n * node\n * python 3.12\n * uv (pip install uv)\n\n### 2. \u5b89\u88c5\u4f9d\u8d56\n```sh\n\ngit clone git@github.com:jobsonlook/xhs-mcp.git\n\ncd xhs-mcp\nuv sync \n\n```\n\n### 3. \u83b7\u53d6\u5c0f\u7ea2\u4e66\u7684cookie\n[\u6253\u5f00web\u5c0f\u7ea2\u4e66](https://www.xiaohongshu.com/explore)\n\u767b\u5f55\u540e\uff0c\u83b7\u53d6cookie\uff0c\u5c06cookie\u914d\u7f6e\u5230\u7b2c4\u6b65\u7684 XHS_COOKIE \u73af\u5883\u53d8\u91cf\u4e2d\n![cookie](https://raw.githubusercontent.com/jobsonlook/xhs-mcp/master/docs/cookie.png)\n\n### 4. \u914d\u7f6emcp server\n\n```json\n{\n    \"mcpServers\": {\n        \"xhs-mcp\": {\n            \"command\": \"uv\",\n            \"args\": [\n                \"--directory\",\n                \"/Users/xxx/xhs-mcp\",\n                \"run\",\n                \"main.py\"\n            ],\n            \"env\": {\n                \"XHS_COOKIE\": \"xxxx\"\n            }\n        }\n    }\n}\n```\n\n## \u514d\u8d23\u58f0\u660e\n\u672c\u9879\u76ee\u4ec5\u7528\u4e8e\u5b66\u4e60\u4ea4\u6d41\uff0c\u7981\u6b62\u7528\u4e8e\u5176\u4ed6\u7528\u9014\uff0c\u4efb\u4f55\u6d89\u53ca\u5546\u4e1a\u76c8\u5229\u76ee\u7684\u5747\u4e0d\u5f97\u4f7f\u7528\uff0c\u5426\u5219\u98ce\u9669\u81ea\u8d1f\u3002\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "\u5c0f\u7ea2\u4e66MCP\u670d\u52a1\u5668 - \u63d0\u4f9b\u5c0f\u7ea2\u4e66API\u529f\u80fd\u7684MCP\u5de5\u5177",
    "version": "0.1.1",
    "project_urls": {
        "Homepage": "https://github.com/jobsonlook/xhs-mcp",
        "Repository": "https://github.com/jobsonlook/xhs-mcp"
    },
    "split_keywords": [
        "api",
        " mcp",
        " server",
        " xiaohongshu"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "5988763ae4a97fb9941922f0bcc1e71b06c51f2339aef10dde6e095802728b0b",
                "md5": "5728f5f3414c5bcc1bff8b106ddd65e9",
                "sha256": "d2ad772af6ad9edd3ec1dd1fbfa6c815ed08f440469d0c04bb4709744e8f9c12"
            },
            "downloads": -1,
            "filename": "jobson_xhs_mcp-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5728f5f3414c5bcc1bff8b106ddd65e9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 65346,
            "upload_time": "2025-08-28T06:43:37",
            "upload_time_iso_8601": "2025-08-28T06:43:37.108234Z",
            "url": "https://files.pythonhosted.org/packages/59/88/763ae4a97fb9941922f0bcc1e71b06c51f2339aef10dde6e095802728b0b/jobson_xhs_mcp-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "5059a476fb7e5cf8df34c122155d8b86cd9c06911a840c61bd9cf7d324ad8876",
                "md5": "71f92cb2f8a5e78b4a1fafa42ac740bf",
                "sha256": "119b3f29d734739d118b21dd7864c05ac0dc98dd8a8af535939fe917c992c66a"
            },
            "downloads": -1,
            "filename": "jobson_xhs_mcp-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "71f92cb2f8a5e78b4a1fafa42ac740bf",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 287101,
            "upload_time": "2025-08-28T06:43:38",
            "upload_time_iso_8601": "2025-08-28T06:43:38.947675Z",
            "url": "https://files.pythonhosted.org/packages/50/59/a476fb7e5cf8df34c122155d8b86cd9c06911a840c61bd9cf7d324ad8876/jobson_xhs_mcp-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-28 06:43:38",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jobsonlook",
    "github_project": "xhs-mcp",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "jobson-xhs-mcp"
}
        
Elapsed time: 0.83194s