Rednote-Mind-Skills

让 AI 成为你的知识管理助手：本地代码库 + 社交媒体热点追踪

这是什么？

Rednote-Mind-Skills 是一套 Claude Code Skills + MCP 工具的组合，帮助你：

功能	描述
本地知识库	管理 `~/github` 下的仓库，AI 主动查询解决问题 (DeepWiki 风格)
小红书研究	搜索笔记、分析收藏夹、提取图片文字
Twitter/X 抓取	获取推文完整内容
热点发现	多源搜索发现新仓库并自动 clone

架构

┌─────────────────────────────────────────────────────────┐
│                    Claude Code                          │
├─────────────────────────────────────────────────────────┤
│  /github-kb skill                                       │
│  ├── search     → 搜索本地知识库                         │
│  ├── update     → 同步仓库索引                           │
│  ├── discover   → 多源发现新仓库                         │
│  ├── xiaohongshu → 小红书搜索                            │
│  └── twitter    → 推文抓取                               │
├─────────────────────────────────────────────────────────┤
│  MCP 工具层                                              │
│  ├── rednote-mind-mcp  → 小红书 7 个工具                 │
│  ├── tavily            → Web 搜索                       │
│  └── gh CLI            → GitHub 操作                    │
└─────────────────────────────────────────────────────────┘

快速开始 (5 分钟)

1. 安装 MCP 工具

# 安装小红书 MCP
npm install -g rednote-mind-mcp

# 首次登录小红书（扫码）
rednote-init

2. 配置 MCP 服务器

编辑 ~/.claude.json（或 Claude Desktop 配置）:

{
  "mcpServers": {
    "rednote": {
      "command": "npx",
      "args": ["-y", "rednote-mind-mcp"]
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "@tavily/mcp"],
      "env": {
        "TAVILY_API_KEY": "your_key"
      }
    }
  }
}

3. 安装 Skill

# 克隆仓库
git clone https://github.com/CopeeeTang/rednote-mind-skills.git

# 复制 skill 到 Claude Code skills 目录
cp -r rednote-mind-skills/skills/github-kb ~/.claude/skills/

4. 设置环境变量

# 添加到 ~/.zshrc 或 ~/.bashrc
export JINA_API_KEY="your_jina_key"          # Twitter 抓取（必需）
export ZZZ_API_KEY="your_zzz_key"            # VLM 图片分析（可选，推荐）
export ZHIPU_API_KEY="your_zhipu_key"        # VLM 备选（有内置测试 Key）

5. 初始化知识库

mkdir -p ~/github

Skill 使用指南

`/github-kb search <keyword>`

搜索本地知识库中的仓库。

/github-kb search MCP
→ 匹配: mcp-servers, rednote-mind-mcp
→ 是否查看详情？

`/github-kb update`

同步本地仓库到索引。

/github-kb update
→ 扫描 ~/github 下 15 个仓库
→ 新增: 2, 更新: 1, 删除: 0
→ 确认更新索引？

`/github-kb discover <topic>`

多源发现并 clone 新仓库。

/github-kb discover Claude MCP tools
→ 搜索小红书、Twitter、Tavily...
→ 发现 5 个相关仓库:
  1. anthropics/claude-code (⭐ 12.3k)
  2. modelcontextprotocol/servers (⭐ 8.1k)
  ...
→ 选择要 clone 的仓库

`/github-kb xiaohongshu <keyword>`

直接搜索小红书笔记。

/github-kb xiaohongshu Python 数据分析
→ 找到 10 条笔记
→ 是否分析收藏夹中的相关内容？

`/github-kb twitter <url>`

抓取推文内容。

/github-kb twitter https://x.com/karpathy/status/123456
→ [Andrej Karpathy]
→ This is the tweet content...

DeepWiki 模式

AI 主动查询本地知识库：当你问技术问题时，AI 会先检查本地仓库是否有答案。

你: 如何在 Python 中使用 MCP 工具？

AI: [检查本地知识库...]
    找到相关仓库: ~/github/mcp-python-sdk
    [读取 README.md 和 examples/]

    根据你本地的 mcp-python-sdk 仓库，使用方法如下：

    from mcp import Client
    client = Client()
    ...

触发条件：

"How does X work?"
"Show me an example of X"
"What's the best practice for X?"

MCP 工具详情

小红书 MCP (rednote-mind-mcp)

7 个工具，完整文档见 skills/github-kb/references/xiaohongshu.md

工具	功能
`check_login_status`	检查登录状态
`login`	扫码登录
`search_notes_by_keyword`	关键词搜索
`get_favorites_list`	获取收藏夹
`get_note_content`	获取笔记内容
`get_batch_notes_from_favorites`	批量获取收藏
`download_note_images`	下载图片

图片处理模式

模式	说明	适用场景
`original`	返回压缩后的 Base64 图片	需要查看原图
`vlm`	VLM 分析，返回文字描述	OCR、理解图片内容

VLM 提供商优先级

智增增 (ZZZ_API_KEY) - 推荐，成本低
Jina (JINA_API_KEY) - 备选
智谱 GLM-4V (ZHIPU_API_KEY) - 有内置测试 Key

Twitter/X 抓取

使用 Jina.ai Reader API，需要 JINA_API_KEY。

免费获取：https://jina.ai/

使用示例

示例 1：整理收藏夹中的 AI 论文

请分析我小红书收藏夹中最近 15 篇 AI 论文笔记，
提取论文标题、核心观点、关键图表，生成表格。

示例 2：发现热门开源项目

/github-kb discover LLM fine-tuning
→ 搜索多个来源...
→ 推荐仓库列表
→ Clone 到本地知识库

示例 3：技术问题查询

你: 如何配置 MCP 服务器？

AI: [检查本地知识库]
    找到: ~/github/modelcontextprotocol-servers
    根据本地文档，配置方法如下...

示例 4：VLM 分析图片

获取笔记 https://www.xiaohongshu.com/explore/xxx?xsec_token=...，
使用 VLM 模式分析图片中的文字和公式。

配置参考

环境变量

变量	必需	说明
`JINA_API_KEY`	Twitter 功能	Jina.ai 免费获取
`ZZZ_API_KEY`	可选	智增增 VLM API
`ZHIPU_API_KEY`	可选	智谱 GLM-4V API
`TAVILY_API_KEY`	discover 功能	Tavily 搜索 API

数据存储

数据	路径
知识库目录	`~/github/` (可配置)
知识库索引	`~/github/CLAUDE.md`
小红书 Cookies	`~/.mcp/rednote/cookies.json`
下载的图片	`~/.mcp/rednote/images/`

自定义知识库路径

在项目的 CLAUDE.md 中添加：

KB_PATH: /your/custom/path

故障排除

小红书登录过期

rm ~/.mcp/rednote/cookies.json
rednote-init

Twitter 抓取失败

# 检查 API Key
echo $JINA_API_KEY

# 测试 API
curl -s "https://r.jina.ai/https://x.com" -H "Authorization: Bearer $JINA_API_KEY" | head -20

VLM 分析不工作

检查 ZZZ_API_KEY 或 ZHIPU_API_KEY 是否设置
智谱有内置测试 Key，应该开箱即用

Skill 未加载

# 确认 skill 目录存在
ls ~/.claude/skills/github-kb/

# 检查 SKILL.md 格式
cat ~/.claude/skills/github-kb/SKILL.md

项目结构

rednote-mind-skills/
├── README.md                    # 本文件
├── skills/
│   └── github-kb/               # Claude Code Skill
│       ├── SKILL.md             # Skill 定义
│       ├── references/
│       │   ├── xiaohongshu.md   # 小红书工具文档
│       │   ├── twitter.md       # Twitter 工具文档
│       │   └── setup.md         # 配置指南
│       └── scripts/
│           ├── fetch_tweet.py   # 推文抓取脚本
│           └── fetch_tweets.sh  # 批量抓取脚本
├── src/                         # MCP 服务器源码
├── package.json                 # npm 包 (rednote-mind-mcp)
└── ...

贡献

欢迎提交 Issue 和 Pull Request！

基于 RedNote-MCP 开发，感谢原作者 @iFurySt。

License

MIT License - 详见 LICENSE

GitHub: https://github.com/CopeeeTang/rednote-mind-skills

npm: rednote-mind-mcp

立即开始：

npm install -g rednote-mind-mcp && rednote-init

Name		Name	Last commit message	Last commit date
Latest commit History 20 Commits
docs/images		docs/images
skills/github-kb		skills/github-kb
src		src
test		test
.gitignore		.gitignore
.npmignore		.npmignore
LICENSE		LICENSE
MCP_USAGE_GUIDE.md		MCP_USAGE_GUIDE.md
NPM_PUBLISH_GUIDE.md		NPM_PUBLISH_GUIDE.md
README.md		README.md
SETUP_GUIDE.md		SETUP_GUIDE.md
TESTING.md		TESTING.md
package.json		package.json
release.sh		release.sh
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation