rednote_mcp_plus 0.7.0__py3-none-any.whl → 0.8.0__py3-none-any.whl

rednote_mcp_plus/read/search.py

@@ -4,12 +4,9 @@ import asyncio
 from rednote_mcp_plus.read.dump import dumpNote
 
 
-async def search(keyWord: str, topN: int, dump: bool) -> str:
+async def search(keyWord: str, topN: int) -> list[str]:
     """
     搜索小红书笔记
-    :param keyWord: 搜索关键词
-    :param topN: 返回前N个结果,不大于10
-    :param dump: 是否导出为Markdown文件
     """
     async with async_playwright() as playwright:
         browser = await playwright.chromium.launch(headless=False)
@@ -20,8 +17,9 @@ async def search(keyWord: str, topN: int, dump: bool) -> str:
         await page.wait_for_timeout(3000)
         login_button = page.locator("form").get_by_role("button", name="登录")
         if(await login_button.is_visible()):
-            return "❌ 未登录小红书，请先登录"
+            return ["❌ 未登录小红书，请先登录"]
         
+        herfs = []
         prefix = 'https://www.xiaohongshu.com'
         links = await page.query_selector_all('a.cover.mask.ld')
         # 获取所有 href 属性
@@ -35,18 +33,13 @@ async def search(keyWord: str, topN: int, dump: bool) -> str:
                 break
         markdown_content = []
         for href in hrefs:
-            markdown_content.append(await dumpNote(href))
-            
-        markdown_content = "\n---\n".join(markdown_content)
+            hrefs.append
 
-        if dump:
-            with open('red_note_search.md', 'w', encoding='utf-8') as f:
-                f.write(markdown_content)
 
         await browser.close()
         await context.close()
             
-        return markdown_content
+        return hrefs
             
         
 

rednote_mcp_plus/server.py

@@ -23,8 +23,6 @@ async def likeNote(
 ) -> str:
     """
     点赞小红书笔记
-    :param noteUrl: 笔记URL
-    :return: 点赞结果
     """
     result = await interaction.likeNote(noteUrl)
     return result
@@ -35,8 +33,6 @@ async def collectNote(
 ) -> str:
     """
     收藏小红书笔记
-    :param noteUrl: 笔记URL
-    :return: 收藏结果
     """
     result = await interaction.collectNote(noteUrl)
     return result
@@ -48,9 +44,6 @@ async def commentNote(
 ) -> str:
     """
     评论小红书笔记
-    :param noteUrl: 笔记URL
-    :param commentText: 评论内容
-    :return: 评论结果
     """
     result = await interaction.commentNote(noteUrl, commentText)
     return result
@@ -61,8 +54,6 @@ async def followUser(
 ) -> str:
     """
     关注小红书用户
-    :param noteUrl: 笔记URL
-    :return: 关注结果
     """
     result = await interaction.followUser(noteUrl)
     return result
@@ -70,17 +61,12 @@ async def followUser(
 @mcp.tool()
 async def searchNotes(
     keyWord: Annotated[str, "搜索关键词"],
-    topN: Annotated[int, "返回前N个结果,不大于10"],
-    dump: Annotated[bool, "是否导出为Markdown文件"]
-) -> str:
+    topN: Annotated[int, "返回前N个结果,不大于10"]
+) -> List[str]:
     """
-    搜索小红书笔记
-    :param keyWord: 搜索关键词
-    :param topN: 返回前N个结果,不大于10
-    :param dump: 是否导出为Markdown文件
-    :return: 搜索结果的Markdown内容
+    搜索小红书笔记,返回笔记URL列表
     """
-    result = await search.search(keyWord, topN, dump)
+    result = await search.search(keyWord, topN)
     return result
 
 @mcp.tool()
@@ -89,8 +75,6 @@ async def dumpNote(
 ) -> str:
     """
     导出小红书笔记内容
-    :param noteUrl: 笔记URL
-    :return: 笔记的Markdown内容
     """
     result = await dump.dumpNote(noteUrl)
     return result
@@ -101,8 +85,6 @@ async def dumpUser(
 ) -> str:
     """
     导出小红书用户信息
-    :param userUrl: 用户主页URL
-    :return: 用户信息文本
     """
     result = await dump_user.dumpUser(userUrl)
     return result
@@ -116,11 +98,6 @@ async def publishText(
 ) -> str:
     """
     发布小红书图文笔记
-    :param image_urls: 图片URL列表
-    :param title: 笔记标题
-    :param content: 笔记内容
-    :param tags: 标签列表
-    :return: 发布结果
     """
     result = await publish.publishText(image_urls, title, content, tags)
     return result

{rednote_mcp_plus-0.7.0.dist-info → rednote_mcp_plus-0.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rednote_mcp_plus
-Version: 0.7.0
+Version: 0.8.0
 Summary: Plus version of MCP server for accessing RedNote
 Author-email: MrMao007 <mty1209@gmail.com>
 Project-URL: Homepage, https://github.com/MrMao007/RedNote-MCP-Plus
@@ -12,7 +12,7 @@ Dynamic: license-file
 
 # RedNote-MCP-Plus
 
-<p align="center"><img src= "logo.png" width="600"/></p>
+<p align="center"><img src= "docs/img/logo.png" width="600"/></p>
 
 [![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
 [![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
@@ -22,19 +22,20 @@ Dynamic: license-file
 ⚙️ 配备更全面工具集的小红书 MCP 服务器。
 
 ## 主要特性
-- 简单易上手：只需要一行命令即可体验工具能力
-- 自动化互动工具：包含发布、点赞、收藏、评论等工具，助力自动化账号运营
+- 简单易上手：只需要几行简单的命令即可体验工具能力，无需额外配置
+- 自动化互动工具：包含发布、点赞、收藏、评论、关注等工具，助力自动化账号运营
 - 自动化爬虫工具：包含搜索、笔记内容爬取、用户数据爬取等工具，助力内容搜索
 
 ## 工具清单
-- 登录：使用其他工具前必须使用该工具登录小红书，保存登录态
-- 点赞：点赞任意笔记
-- 收藏：收藏任意笔记
-- 评论：评论任意笔记
-- 发布笔记：发布任意图文笔记
-- 搜索笔记：关键词搜索笔记
-- 笔记内容爬取：以MarkDown形式保存任意笔记
-- 用户数据爬取：获取用户昵称、简介、标签、互动信息
+- ✅登录：使用其他工具前必须使用该工具登录小红书，保存登录态
+- ❤️点赞：点赞任意笔记
+- 📥收藏：收藏任意笔记
+- 💬评论：评论任意笔记
+- 👤关注：关注任意用户
+- 🖼️发布笔记：发布任意图文笔记
+- 🔍搜索笔记：关键词搜索笔记
+- 📖笔记内容爬取：以MarkDown形式保存任意笔记
+- 📊用户数据爬取：获取用户昵称、简介、标签、互动信息
 
 ## 快速开始
 
@@ -57,15 +58,34 @@ playwright install
 brew install node
 ```
 
+4. 安装小红书MCP
+```
+uv tool install rednote_mcp_plus
+```
+
 ### 快速试用
 
-一行命令启动MCP服务调试!
+**一行命令启动MCP服务调试!**
 ```
 npx @modelcontextprotocol/inspector uvx rednote_mcp_plus
 ```
 
+如果一切顺利的话，现在你就可以看到如图所示列出的所有工具了，接下来你可以随意试用感兴趣的MCP工具了！
+
+![MCP工具列表](docs/img/mcp_tools.png "MCP工具列表")
+
+> ⚠️ **注意：** 请务必先使用manualLogin工具登录小红书后再体验其他工具！
+
+### 效果展示
+
+图中展示了获取笔记内容的结果，包含了标题、作者、图文/视频、正文、标签、互动数据、发布时间、发布地点等数据。
+
+![小红书笔记](docs/img/note.png "小红书笔记")
+
 ## MCP服务器配置
 
+以Cline配置为例：
+
 ```
 {
   "mcpServers": {

{rednote_mcp_plus-0.7.0.dist-info → rednote_mcp_plus-0.8.0.dist-info}/RECORD

@@ -1,15 +1,15 @@
 rednote_mcp_plus/__init__.py,sha256=iEHRRb2Eu2WLfcRPcxuC1SGQHZddpRpucEtwHfbvSk0,244
 rednote_mcp_plus/__main__.py,sha256=dX9L5QduXiar7rVpjg59RuNhtMUu8E7naE0NLDRoGXM,40
-rednote_mcp_plus/server.py,sha256=6e4drGXf8RHS58C_grvbiA2xGjY8RmbUoLO4CvZblvA,3287
+rednote_mcp_plus/server.py,sha256=KkLem69kcjATc9dXxhnEuaEIzSANW-yNwJVkE3fnV-M,2519
 rednote_mcp_plus/auth/login.py,sha256=UGQM1WWRM2cGVa8YWflOsscS7zcVQRj9yQnwZVt27lo,1873
 rednote_mcp_plus/read/dump.py,sha256=Nvr8zksMZXyN_9AhJjfsr7YHEz8SVi-M3juTUFVRsTk,4263
 rednote_mcp_plus/read/dump_user.py,sha256=2nlG97Qoi5k0oFCJUwVJQD2hAou1IaaZnvVYf65QDq0,2340
-rednote_mcp_plus/read/search.py,sha256=jrqCK-9lebq9gPE1n57D9Bc7_7vf_aFUhb5W8NJp1NI,1933
+rednote_mcp_plus/read/search.py,sha256=tSv8_M0VFBF8ZydQYD9h5_l6KSkTuu8Ia0sYwL7BQS8,1567
 rednote_mcp_plus/write/interaction.py,sha256=m_KJqslL6x_BKTlVd9VIqiZFK_Dht0W4cVZgBObpFF4,4316
 rednote_mcp_plus/write/publish.py,sha256=qb79phSyYFdnMKA-pQSBxCy0hDW_dj7uLEfRe8zLRfU,3322
-rednote_mcp_plus-0.7.0.dist-info/licenses/LICENSE,sha256=9tK-YRom1vbLVHstEu8kyX_PBx2niXMVL3cwA3IAmxk,1065
-rednote_mcp_plus-0.7.0.dist-info/METADATA,sha256=g7TBB6z1_JkOQNGTYuAbPqRil4KT9Fu5UntFsQddJv0,2106
-rednote_mcp_plus-0.7.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-rednote_mcp_plus-0.7.0.dist-info/entry_points.txt,sha256=OBNoUIMggl953wkVHSjljLTcnU4HOlr9XhZamcGnWS8,59
-rednote_mcp_plus-0.7.0.dist-info/top_level.txt,sha256=mk1SLfb9HVLpSRSbgn9eej-n3NmE9aeSaXZpHwjE0ZE,17
-rednote_mcp_plus-0.7.0.dist-info/RECORD,,
+rednote_mcp_plus-0.8.0.dist-info/licenses/LICENSE,sha256=9tK-YRom1vbLVHstEu8kyX_PBx2niXMVL3cwA3IAmxk,1065
+rednote_mcp_plus-0.8.0.dist-info/METADATA,sha256=hmcWhC3gLXBryGxgemuuBqGhNzKdzJ5Yazr2zwCVxf4,2867
+rednote_mcp_plus-0.8.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+rednote_mcp_plus-0.8.0.dist-info/entry_points.txt,sha256=OBNoUIMggl953wkVHSjljLTcnU4HOlr9XhZamcGnWS8,59
+rednote_mcp_plus-0.8.0.dist-info/top_level.txt,sha256=mk1SLfb9HVLpSRSbgn9eej-n3NmE9aeSaXZpHwjE0ZE,17
+rednote_mcp_plus-0.8.0.dist-info/RECORD,,