Mcp.env

के द्वारा बनाया गया

chaseSpace•Jun 26, 2025

mcp_fetch_xhs_post

अनुसंधान और डेटा

सारांश

mcp_fetch_xhs_post क्या है?

mcp_fetch_xhs_post एक सार्वजनिक रिपॉजिटरी है जिसे उपयोगकर्ता ### chaseSpace ने GitHub पर बनाया है। यह रिपॉजिटरी XHS (Xiaohongshu) प्लेटफॉर्म से पोस्ट लाने के लिए डिज़ाइन की गई है, जो चीन में एक लोकप्रिय सोशल मीडिया और ई-कॉमर्स प्लेटफॉर्म है। इस रिपॉजिटरी में संभवतः स्क्रिप्ट या उपकरण शामिल हैं जो उपयोगकर्ताओं को XHS से पोस्ट निकालने, विश्लेषण करने या इंटरैक्ट करने की अनुमति देते हैं, जिससे यह सोशल मीडिया डेटा में रुचि रखने वाले डेवलपर्स और डेटा विश्लेषकों के लिए एक मूल्यवान संसाधन बनता है।

mcp_fetch_xhs_post की विशेषताएँ

सार्वजनिक पहुंच: यह रिपॉजिटरी सार्वजनिक रूप से उपलब्ध है, जिससे कोई भी प्रोजेक्ट को देख सकता है, क्लोन कर सकता है या योगदान दे सकता है।
डेटा लाना: यह XHS प्लेटफॉर्म से पोस्ट लाने की कार्यक्षमता प्रदान करता है, जो डेटा विश्लेषण, शोध या एप्लिकेशन विकास के लिए उपयोगी हो सकता है।
ओपन सोर्स: एक ओपन-सोर्स प्रोजेक्ट होने के नाते, उपयोगकर्ता इसके विकास में योगदान कर सकते हैं, समस्याओं की रिपोर्ट कर सकते हैं, या सुधारों का सुझाव दे सकते हैं।
समुदाय की भागीदारी: उपयोगकर्ता रिपॉजिटरी को स्टार कर सकते हैं ताकि सराहना दिखा सकें, इसे फोर्क कर सकते हैं ताकि अपने संस्करण बना सकें, या सूचनाओं के माध्यम से अपडेट का पालन कर सकते हैं।

mcp_fetch_xhs_post का उपयोग कैसे करें

रिपॉजिटरी क्लोन करें: Git का उपयोग करके रिपॉजिटरी को अपने स्थानीय मशीन पर क्लोन करें।
```
git clone https://github.com/chaseSpace/mcp_fetch_xhs_post.git
```
निर्भरताएँ स्थापित करें: क्लोन की गई निर्देशिका में जाएँ और किसी भी आवश्यक निर्भरताओं को स्थापित करें, जो आमतौर पर requirements.txt फ़ाइल या समान में सूचीबद्ध होती हैं।
```
cd mcp_fetch_xhs_post
pip install -r requirements.txt
```
लाने वाली स्क्रिप्ट चलाएँ: XHS से पोस्ट लाने के लिए मुख्य स्क्रिप्ट को निष्पादित करें।
```
python fetch_xhs_posts.py
```
डेटा का विश्लेषण करें: एक बार डेटा लाने के बाद, आप इसे अपने पसंदीदा डेटा विश्लेषण उपकरणों या पुस्तकालयों का उपयोग करके विश्लेषण कर सकते हैं।

अक्सर पूछे जाने वाले प्रश्न

mcp_fetch_xhs_post में कौन सी प्रोग्रामिंग भाषा का उपयोग किया गया है?

यह रिपॉजिटरी मुख्य रूप से Python में लिखी गई है, जो डेटा लाने और विश्लेषण कार्यों के लिए सामान्यतः उपयोग की जाती है।

क्या मैं mcp_fetch_xhs_post रिपॉजिटरी में योगदान कर सकता हूँ?

हाँ, योगदान का स्वागत है! आप रिपॉजिटरी को फोर्क कर सकते हैं, अपने परिवर्तन कर सकते हैं, और समीक्षा के लिए एक पुल अनुरोध सबमिट कर सकते हैं।

क्या mcp_fetch_xhs_post के लिए कोई दस्तावेज़ उपलब्ध है?

दस्तावेज़ीकरण संभवतः रिपॉजिटरी के भीतर उपलब्ध है, आमतौर पर README.md फ़ाइल या docs निर्देशिका में। उपयोग निर्देशों और दिशानिर्देशों के लिए हमेशा वहाँ जांचें।

मैं रिपॉजिटरी में समस्याओं या बग की रिपोर्ट कैसे कर सकता हूँ?

आप GitHub पर रिपॉजिटरी के "Issues" टैब पर जाकर और उस समस्या के बारे में विवरण के साथ एक नया मुद्दा सबमिट करके समस्याएँ रिपोर्ट कर सकते हैं जिसका आप सामना कर रहे हैं।

क्या 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 进行分发，目前仅支持本地部署运行。

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

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

uv sync

启动：

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与我联系。

सर्वर कॉन्फ़िगरेशन

{
  "mcpServers": {
    "mcp_fetch_xhs_post": {
      "command": "仅支持本地sse部署",
      "args": [],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

परियोजना जानकारी

लेखक

chaseSpace