Mcp.env

什么是 mcp_fetch_xhs_post？

mcp_fetch_xhs_post 是由用户 ### chaseSpace 在 GitHub 上创建的公共仓库。该仓库旨在从 XHS（小红书）平台获取帖子，XHS 是中国一个受欢迎的社交媒体和电子商务平台。该仓库可能包含允许用户提取、分析或与 XHS 帖子互动的脚本或工具，使其成为对社交媒体数据感兴趣的开发者和数据分析师的宝贵资源。

mcp_fetch_xhs_post 的特点

• 公共访问：该仓库是公开可访问的，任何人都可以查看、克隆或为该项目做贡献。
• 数据获取：它提供从 XHS 平台获取帖子的功能，这对数据分析、研究或应用开发非常有用。
• 开源：作为一个开源项目，用户可以为其开发做贡献、报告问题或建议改进。
• 社区参与：用户可以为该仓库加星以表示赞赏，分叉以创建自己的版本，或通过通知关注更新。

如何使用 mcp_fetch_xhs_post

1. 克隆仓库：使用 Git 将仓库克隆到本地机器。

   git clone https://github.com/chaseSpace/mcp_fetch_xhs_post.git
   

2. 安装依赖：导航到克隆的目录并安装任何所需的依赖，通常在 requirements.txt 文件或类似文件中列出。

   cd mcp_fetch_xhs_post
   pip install -r requirements.txt
   

3. 运行获取脚本：执行主脚本以开始从 XHS 获取帖子。

   python fetch_xhs_posts.py
   

4. 分析数据：一旦数据被获取，您可以使用您喜欢的数据分析工具或库进行分析。

常见问题解答

mcp_fetch_xhs_post 使用了什么编程语言？

该仓库主要使用 Python 编写，Python 通常用于数据获取和分析任务。

我可以为 mcp_fetch_xhs_post 仓库做贡献吗？

可以，欢迎贡献！您可以分叉该仓库，进行更改，并提交拉取请求以供审核。

mcp_fetch_xhs_post 有任何文档可用吗？

文档可能在仓库内部提供，通常在 README.md 文件或 docs 目录中。请始终检查那里以获取使用说明和指南。

我如何报告仓库中的问题或错误？

您可以通过导航到 GitHub 上仓库的“问题”选项卡，提交一个新问题并详细描述您遇到的问题来报告问题。

使用 mcp_fetch_xhs_post 有任何先决条件吗？

您可能需要在您的机器上安装 Python，以及仓库文档中指定的任何必要库。

Python-MCP-Server：小红书热帖获取

本项目基于 FastMCP SDK 开发，功能是根据指定“关键词”获取小红书的热帖数据，默认获取5~ 10篇（参数控制），不支持翻页获取。

1. Tools

• fetch_xhs_hot_post：从小红书获取爆款帖子数据
  • 具体包括每篇帖子的标题、内容、发布时间、标签等数据，请查看 model.py 中的 Post class了解更多。

2. 准备

2.1 环境要求

• Python 3.12+
• Chrome浏览器，Centos 安装参考这里

2.2 外部环境变量

由于目标网站需要登录后才可以搜索内容，因为本项目使用了钉钉来接收登录二维码，请先在钉钉群中添加机器人（安全设置选择加签）， 并获取必要信息作为环境变量注入环境，如下示例：

### mcp.env
DINGTALK_WEBHOOK_URI=https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN
DINGTALK_SECRET=YOUR_SECRET

将上述环境变量放入项目根目录下的mcp.env文件（自行创建）中即可。

3. 安装运行

注：本项目并未通过 pypi 进行分发，目前仅支持本地部署运行。

1. 首先Clone本项目，然后使用uv命令安装依赖：

### 若未安装uv，可通过pip等方式安装
cd mcp_fetch_xhs_post
source .venv/Scripts/activate # 激活venv。若是windows cmd环境，则执行 .\.venv\Scripts\activate.bat 

uv sync

2. 启动：

uv run main.py

4. 添加MCP Server

项目启动后，在所使用的MCP Client添加一个MCP Server，关键配置如下

• 名称：小红书热帖获取
• 传输类型：SSE
• URL：http://127.0.0.1:9090/sse （假设在本机运行MCP Server，端口可在代码中修改）

5. 运行流程

项目启动且成功添加到MCP Client后，就可以开始使用了。

第一次运行时，由于本地的Chrome浏览器可能没有登录小红书PC网站，程序会自动将用于登录的二维码发送至钉钉群中， 请进入钉钉群扫码登陆，程序将会等待30s，如超时工具会自动重试最多3次。登陆成功后，程序也会将登陆成功的消息发送至钉钉群中。 之后会开始获取数据，在启动项目的控制台输出中可以看到运行日志打印。

6. 免责声明

6.1 目的

本项目旨在提供一个教育和研究工具，用于学习和理解MCP、网络爬虫技术的实现和应用。本项目不鼓励或支持任何违反服务条款或法律法规的行为。

6.2 服务条款遵守

使用本项目前，请确保您已经阅读并理解目标网站（如小红书）的服务条款。本项目不保证对目标网站的服务条款完全兼容，使用本项目爬取数据可能违反目标网站的服务条款。

6.3 合法性

用户在使用本项目时应确保其行为符合当地法律法规及目标网站的使用政策。本项目不对因违反法律法规或服务条款而导致的任何后果承担责任。

6.4 数据使用

用户应仅将通过本项目爬取的数据用于合法和正当的目的。不得将数据用于商业目的、侵犯版权、侵犯个人隐私或其他不当用途。

6.5 风险自负

使用本项目爬取数据存在被目标网站封禁或其他形式的反爬措施的风险。用户应自行承担使用本项目可能带来的所有风险。

6.6 开源协议

本项目遵循 MIT License 开源协议。在遵循开源协议的前提下，您可以自由地使用、修改和分发本项目。

6.7 免责声明

本项目“按原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于对适销性、特定用途适用性和非侵权性的保证。在任何情况下， 作者或贡献者均不对因使用本项目而产生的任何直接的、间接的、偶然的、特殊的、惩罚性的或后果性的损害负责，包括但不限于替代商品或服务的采购、 使用、数据或利润的损失，或业务中断，无论此类损害是如何引起的，也无论是否已告知可能发生此类损害的可能性。

6.8 联系方式

如果您对本项目有任何疑问或担忧，或发现本项目可能违反了法律法规或服务条款，请通过Github issue与我联系。