Skip to main content

小红书自动化工具mcp服务器,提供小红书内容发布及交互功能

Project description

自动化小红书MCP服务器

这是一个基于MCP的小红书内容创作和管理工具,可以帮助你自动化小红书内容平台的操作,包括搜索笔记、发布笔记、评论等功能。

功能特点

  • 🔍 搜索小红书笔记内容
  • 📝 发布图文/视频笔记
  • 💬 自动评论笔记
  • 🏠 获取首页推荐内容
  • 🔐 支持账号登录与验证

快速开始

1. 环境要求

  • node.js
  • python 3.12
  • uv (pip install uv)

2. 安装依赖

git clone https://github.com/fancyboi999/xhs-auto-mcp.git

cd xhs-auto-mcp
uv venv
source .venv/bin/activate
uv pip install -e .

3. 获取小红书的cookie

打开网页端小红书 登录后,获取内容平台的cookie,将cookie配置到MCP服务的 XHS_COOKIE 环境变量中 获取cookie教程

4. 配置MCP服务

有两种方式可以配置和启动MCP服务,环境变量JSON_PATH 是用于存储创作平台token与cookie,因此请填写绝对路径:

方式一:使用stdio协议(直接连接)

在Claude配置中添加以下内容:

{
    "mcpServers": {
        "xhs-auto-mcp": {
            "command": "uvx",
            "args": ["xhs-auto-mcp", "--transport", "stdio"],
            "env": {
                "XHS_COOKIE": "xxxx",
                "JSON_PATH": "your_token_save_path"
            }
        }
    }
}

方式二:使用HTTP协议

  1. 启动HTTP服务:
env XHS_COOKIE=xxxx JSON_PATH=your_token_save_path uvx xhs-auto-mcp --transport http --port 8080
  1. 在Claude配置中添加以下内容:
{
    "mcpServers": {
        "xhs-auto-mcp": {
            "type": "http",
            "url": "http://localhost:8080/mcp"
        }
    }
}

工具使用说明

本项目提供了多种工具来操作小红书平台:

可用工具

内容平台工具

  • 检查cookie有效性: 验证当前cookie是否有效
  • 获取首页推荐笔记: 获取小红书首页推荐内容
  • 搜索笔记: 根据关键词搜索笔记
  • 获取笔记内容: 获取指定笔记的详细内容
  • 获取笔记评论: 获取指定笔记的评论
  • 发表评论: 对指定笔记发表评论

创作平台工具

  • 登录: 通过手机号和验证码登录小红书创作平台
  • 发布图文笔记: 创建并发布包含图片的笔记
  • 发布视频笔记: 创建并发布包含视频的笔记

示例视频

查看演示视频了解如何使用本工具:演示视频

免责声明

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_fancyboi999_xhs_auto_mcp-0.1.1.tar.gz (72.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_fancyboi999_xhs_auto_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: iflow_mcp_fancyboi999_xhs_auto_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 72.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_fancyboi999_xhs_auto_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 78313ad0ac2df972c7e62d16a23dbc90f7faebeb11264c535db2bd43370043ec
MD5 f7e4ce984c3cb15fdb985153df1e4e08
BLAKE2b-256 49de5d9bae6ad36f679aa15a7fcc483c8acf568465b5b7a7c98bdc2c05d1e5b1

See more details on using hashes here.

File details

Details for the file iflow_mcp_fancyboi999_xhs_auto_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_fancyboi999_xhs_auto_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 74.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_fancyboi999_xhs_auto_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 067967d860f38aeb76c292c502cfce45c64f49352ff4003c7251bdb3811f8eea
MD5 0172fb758ba7d08f987afe983ee715c5
BLAKE2b-256 25b66cad1f313d99517db1ee8547dc8fe8412ce82cd0f0a0388c8fdcad0540eb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page