Mcp.env

Что такое mcp_fetch_xhs_post?

mcp_fetch_xhs_post — это публичный репозиторий, созданный пользователем ### chaseSpace на GitHub. Этот репозиторий предназначен для извлечения постов с платформы XHS (Xiaohongshu), которая является популярной социальной медиа и электронной коммерции в Китае. Репозиторий, вероятно, содержит скрипты или инструменты, которые позволяют пользователям извлекать, анализировать или взаимодействовать с постами из 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, который часто используется для задач извлечения и анализа данных.

Могу ли я внести вклад в репозиторий mcp_fetch_xhs_post?

Да, вклады приветствуются! Вы можете форкнуть репозиторий, внести изменения и отправить запрос на слияние для рассмотрения.

Есть ли какая-либо документация для mcp_fetch_xhs_post?

Документация может быть доступна внутри самого репозитория, обычно в файле README.md или каталоге docs. Всегда проверяйте там инструкции по использованию и рекомендации.

Как я могу сообщить о проблемах или ошибках в репозитории?

Вы можете сообщить о проблемах, перейдя на вкладку "Issues" репозитория на 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与我联系。