[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-11460":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":16,"starSnapshotCount":16,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},11460,"Spider_XHS","cv-cat\u002FSpider_XHS","cv-cat","小红书爬虫数据采集，小红书全域运营解决方案",null,"https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FSpider_XHS","JavaScript",6311,1127,30,107,0,72,183,533,216,112.16,false,"main","2026-06-12 04:00:55","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FSpider_XHS\" target=\"_blank\">\n    \u003Cpicture>\n      \u003Cimg width=\"220\" src=\".\u002Fauthor\u002Flogo.jpg\" alt=\"Spider_XHS logo\">\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cdiv align=\"center\">\n\n# Spider_XHS\n\n**专业的小红书数据采集 & 全域运营解决方案 & Agent Skills**\n\n[![Skills](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fskills-supported-success)](https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FXhsSkills)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.10%2B-blue)](https:\u002F\u002Fwww.python.org\u002F)\n[![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnodejs-20%2B-green)](https:\u002F\u002Fnodejs.org\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-orange)](LICENSE)\n\n\u003C\u002Fdiv>\n\n> **在 AI 大模型爆发的时代，内容运营的竞争本质是效率竞争。**\n> 本项目封装了小红书平台完整的数据采集与内容发布能力，为开发者构建 AI 运营智能体提供可靠、稳定的底层 API 支撑。\n\n**⚠️ 本项目仅供学习交流使用，禁止任何商业化行为，如有违反，后果自负**\n\n---\n\n## 为什么需要这个项目？\n\n```\n采集竞品笔记 ──► [Spider_XHS] ──► 你的 AI Agent（改写 \u002F 生成 \u002F 分析）──► 自动上传发布\n                     ▲                                                        │\n                     └──────────── 获取数据 \u002F 管理账号 ◄──────────────────────┘\n```\n\n小红书没有开放完整的内容运营接口。想要接入 AI 大模型实现内容批量采集、智能改写、一键发布，首先需要能**稳定读写平台数据**。Spider_XHS 解决的正是这个前置问题：\n\n- 逆向还原了小红书 PC 端与创作者平台的签名算法（a1 \u002F web_id \u002F websectiga \u002F sec_poison_id \u002F gid \u002F x-s \u002F x-t \u002F x-s-common \u002F x-b3-traceid \u002F x-xray-traceid \u002F x-rap-param \u002F search_id \u002F request_id \u002F sign \u002F q-signature 等参数）\n- 封装全部核心 HTTP 接口，签名参数已透明处理\n- 同时覆盖 **数据采集**（PC端）、**内容发布**（创作者平台）、**KOL数据**（蒲公英）三大场景\n\n**你负责接 AI 大脑，我们负责打通小红书的神经。**\n\n---\n\n## 成品\n\n### repo地址： [XHS_ALL_IN_ONE](https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FXHS_ALL_IN_ONE)\n\n### 账号矩阵 — 多账号绑定与健康管理\n\n支持绑定多个 PC \u002F Creator 账号，扫码登录、手机验证码、Cookie 导入三种方式。Cookie 加密存储，2 小时自动健康巡检，过期自动通知。\n\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FXHS_ALL_IN_ONE\u002Fblob\u002Fmaster\u002Fstatic\u002Ffrontend_1.jpg\" width=\"600\" \u002F>\n\n### 素材优化 — AI 图片润色\n\n选择草稿中的任意图片，添加参考图，输入润色指令，AI 生成优化后的图片并原位替换。当前素材和优化结果并排对比，点击即可放大预览。\n\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FXHS_ALL_IN_ONE\u002Fblob\u002Fmaster\u002Fstatic\u002Ffrontend_5.jpg\" width=\"600\" \u002F>\n\n### 发布中心 — 一键发布到小红书\n\n预览草稿内容和图片素材，选择 Creator 账号，设置可见性和发布模式（立即\u002F定时），发布校验通过后一键发布到小红书创作者平台。\n\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FXHS_ALL_IN_ONE\u002Fblob\u002Fmaster\u002Fstatic\u002Ffrontend_6.jpg\" width=\"600\" \u002F>\n\n---\n\n## 🧩 Skills 支持\n\n当前项目已经支持基于 skills 的能力接入，既可以直接作为 `Spider_XHS` 的底层能力仓库使用，也可以通过标准化 skills 方式被上层 Agent 工具链引入。\n\n如果你希望直接复用已经封装好的 skills，可以查看 [XhsSkills](https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FXhsSkills)。该仓库专门用于存放基于 `Spider_XHS` 封装的 Agent Skills，目前可被 `Clawbot`、`Claude Code`、`Codex` 等支持 skills 的工具直接引入与集成。\n\n---\n\n## ⭐ 已实现功能\n\n| 模块 | 功能 | 状态 |\n|------|------|------|\n| **小红书 PC 端** | 二维码登录 \u002F 手机验证码登录 | ✅ |\n| | 获取主页所有频道 & 推荐笔记 | ✅ |\n| | 获取用户主页信息 \u002F 自己的账号信息 | ✅ |\n| | 获取用户发布 \u002F 喜欢 \u002F 收藏的所有笔记 | ✅ |\n| | 获取笔记详细内容（无水印图片 & 视频） | ✅ |\n| | 搜索笔记 & 搜索用户 | ✅ |\n| | 获取笔记评论 | ✅ |\n| | 获取未读消息 \u002F 评论@提醒 \u002F 点赞收藏 \u002F 新增关注 | ✅ |\n| **创作者平台** | 二维码登录 \u002F 手机验证码登录 | ✅ |\n| | 上传图集作品 | ✅ |\n| | 上传视频作品 | ✅ |\n| | 查看已发布作品列表 | ✅ |\n| **蒲公英平台** | 获取 KOL 博主列表 & 详细数据 | ✅ |\n| | 获取博主粉丝画像 & 历史趋势 | ✅ |\n| | 发起合作邀请 | ✅ |\n| **千帆平台** | 获取分销商列表 & 详细数据 | ✅ |\n| | 获取分销商合作品类 \u002F 店铺 \u002F 商品信息 | ✅ |\n\n---\n\n## 🤖 接入 AI 智能体\n\nSpider_XHS 天然适合作为 AI 运营 Agent 的数据底座，以下是几种典型用法：\n\n### 场景一：竞品笔记采集 + AI 改写 + 自动发布\n\n```python\nfrom apis.xhs_pc_apis import XHS_Apis\nfrom apis.xhs_creator_apis import XHS_Creator_Apis\n\npc_api = XHS_Apis()\ncreator_api = XHS_Creator_Apis()\n\n# 1. 采集竞品笔记\nsuccess, msg, note = pc_api.get_note_info(note_url, cookies_str)\n\n# 2. 交给 AI 改写（接入任意大模型）\nrewritten = your_ai_agent(note['content'])   # GPT \u002F Claude \u002F Qwen \u002F 本地模型\n\n# 3. 自动上传到创作者平台\ncreator_api.post_note({\n    \"title\": rewritten['title'],\n    \"desc\": rewritten['desc'],\n    \"media_type\": \"image\",\n    \"images\": [...],\n    ...\n}, creator_cookies_str)\n```\n\n### 场景二：关键词监控 + AI 情报分析\n\n```python\n# 搜索指定关键词的最新笔记，交给 AI 分析趋势\nsuccess, msg, notes = pc_api.search_some_note(query, require_num, cookies_str, ...)\nanalysis = your_ai_agent(notes)\n```\n\n### 场景三：KOL 筛选 + 智能匹配\n\n```python\nfrom apis.xhs_pugongying_apis import PuGongYingAPI\n\npgy = PuGongYingAPI()\n# 获取目标类目的 KOL 数据，交给 AI 评估匹配度\nkol_list = pgy.get_some_user(num=50, cookies=cookies)\nbest_kols = your_ai_agent(kol_list, brand_profile)\n```\n\n---\n\n## 🎨 爬虫效果图\n\n### 处理后的所有用户\n![image](https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FSpider_XHS\u002Fassets\u002F94289429\u002F00902dbd-4da1-45bc-90bb-19f5856a04ad)\n\n### 某个用户所有的笔记\n![image](https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FSpider_XHS\u002Fassets\u002F94289429\u002F880884e8-4a1d-4dc1-a4dc-e168dd0e9896)\n\n### 某个笔记具体的内容\n![image](https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FSpider_XHS\u002Fassets\u002F94289429\u002Fd17f3f4e-cd44-4d3a-b9f6-d880da626cc8)\n\n### 保存的 Excel\n![image](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F707f20ed-be27-4482-89b3-a5863bc360e7)\n\n---\n\n## 🛠️ 快速开始\n\n### ⛳ 环境要求\n\n- Python 3.10+\n- Node.js 20+\n\n### 🎯 安装依赖\n\n```bash\npip install -r requirements.txt\nnpm install\n```\n\n### 🎨 配置 Cookie\n\n在项目根目录的 `.env` 文件中填入你的登录 Cookie：\n\n```\nCOOKIES='your_cookie_here'\n```\n\nCookie 获取方式：浏览器登录小红书后，按 `F12` 打开开发者工具 → 网络 → Fetch\u002FXHR → 找任意一个请求 → 复制请求头中的 `cookie` 字段。\n\n![image](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F6a7e4ecb-0432-4581-890a-577e0eae463d)\n\n![image](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F5e62bc35-d758-463e-817c-7dcaacbee13c)\n\n> **注意：必须是登录后的 Cookie，未登录状态无效。**\n\n### 🚀 运行项目\n\n```bash\npython -m spider.spider\n```\n\n### 🐳 Docker 部署（可选）\n\n```bash\ndocker build -t spider_xhs .\ndocker run -e COOKIES='your_cookie_here' spider_xhs\n```\n\n---\n\n## 📁 项目结构\n\n```\nSpider_XHS\u002F\n├── spider\u002F\n│   ├── __init__.py\n│   └── spider.py                    # 主入口：爬虫调用示例\n├── apis\u002F\n│   ├── xhs_pc_apis.py               # 小红书PC端完整API（采集）\n│   ├── xhs_creator_apis.py          # 创作者平台API（上传发布）\n│   ├── xhs_pc_login_apis.py         # PC端登录（二维码\u002F手机验证码）\n│   ├── xhs_creator_login_apis.py    # 创作者平台登录\n│   ├── xhs_pugongying_apis.py       # 蒲公英平台API（KOL数据）\n│   └── xhs_qianfan_apis.py          # 千帆平台API（分销商数据）\n├── xhs_utils\u002F\n│   ├── common_util.py               # 初始化工具（读取.env配置）\n│   ├── cookie_util.py               # Cookie解析\n│   ├── data_util.py                 # 数据处理（Excel保存、媒体下载）\n│   ├── xhs_util.py                  # PC端签名算法封装\n│   ├── xhs_creator_util.py          # 创作者平台签名算法封装\n│   ├── xhs_pugongying_util.py       # 蒲公英平台工具\n│   └── xhs_qianfan_util.py          # 千帆平台工具\n├── static\u002F\n│   ├── xhs_main_260411.js           # PC端签名核心JS（最新版）\n│   ├── xhs_rap.js                   # PC端 x-rap-param JSVMP 补环境生成脚本\n│   ├── xhs_creator_260411.js        # 创作者平台签名核心JS（最新版）\n│   └── ...\n├── .env                             # Cookie配置（不要提交到git）\n├── requirements.txt\n├── Dockerfile\n└── package.json\n```\n\n---\n\n## 🗝️ 注意事项\n\n- `spider\u002Fspider.py` 是爬虫入口，可根据需求修改调用逻辑\n- `apis\u002Fxhs_pc_apis.py` 包含所有 PC 端数据接口\n- `apis\u002Fxhs_creator_apis.py` 包含创作者平台发布接口\n- Cookie 有时效性，失效后需重新获取\n- 建议配合代理（proxies 参数）使用，降低封号风险\n\n---\n\n## 🍥 更新日志\n\n| 日期 | 说明 |\n|------|------|\n| 23\u002F08\u002F09 | 首次提交 |\n| 23\u002F09\u002F13 | API 更改 params 增加两个字段，修复图片无法下载，修复部分页面无法访问报错 |\n| 23\u002F09\u002F16 | 修复较大视频编码问题，加入异常处理 |\n| 23\u002F09\u002F18 | 代码重构，加入失败重试 |\n| 23\u002F09\u002F19 | 新增下载搜索结果功能 |\n| 23\u002F10\u002F05 | 新增跳过已下载功能，获取更详细的笔记和用户信息 |\n| 23\u002F10\u002F08 | 上传至 PyPI，可通过 pip install 安装 |\n| 23\u002F10\u002F17 | 搜索下载新增排序方式（综合 \u002F 热门 \u002F 最新） |\n| 23\u002F10\u002F21 | 新增图形化界面，上传至 release v2.1.0 |\n| 23\u002F10\u002F28 | Fix Bug：修复搜索功能隐藏问题 |\n| 25\u002F03\u002F18 | 更新 API，修复部分问题 |\n| 25\u002F06\u002F07 | 更新 search 接口，区分视频和图集下载，新增创作者平台 API |\n| 25\u002F07\u002F15 | 更新 xs version56 & 小红书创作者接口 |\n| 26\u002F04\u002F11 | 重构创作者平台 API（图集 \u002F 视频上传），新增蒲公英 KOL 数据 API，新增千帆分销商 API，签名算法升级至最新版 |\n| 26\u002F04\u002F28 | 更新 PC 端搜索与笔记详情风控参数，新增 `search_id` 当前算法与 `x-rap-param` 本地 JSVMP 生成，补充 `a1`、`web_id`、`websectiga` 等签名参数说明 |\n\n---\n\n## 🧸 额外说明\n\n1. 感谢 Star ⭐ 和 Follow，项目会持续更新\n2. 作者联系方式在主页，有问题随时联系\n3. 欢迎 PR 和 Issue，也欢迎关注作者其他项目\n4. 如果此项目对您有帮助，欢迎请作者喝一杯奶茶 ~~（开心一整天 😊）\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\".\u002Fauthor\u002Fwx_pay.png\" width=\"380px\" alt=\"微信赞赏码\">\n  \u003Cimg src=\".\u002Fauthor\u002Fzfb_pay.jpg\" width=\"380px\" alt=\"支付宝收款码\">\n\u003C\u002Fdiv>\n\n---\n\n## 📈 Star 趋势\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#cv-cat\u002FSpider_XHS&Date\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=cv-cat\u002FSpider_XHS&type=Date&theme=dark\" \u002F>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=cv-cat\u002FSpider_XHS&type=Date\" \u002F>\n    \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=cv-cat\u002FSpider_XHS&type=Date\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n---\n\n## 🍔 交流群\n\n如果你对爬虫和 AI Agent 感兴趣，请加作者主页 wx 通过邀请加入群聊\n\nps: 请加群11、12，人满或者过期 issue | wx 提醒\n\n![group11](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7fdded35-52ca-4bcb-a5b7-935928ed417c)\n\n![group12](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F8dd858be-5843-4074-a2d5-fc48b3d61856)\n\n","Spider_XHS 是一个专注于小红书平台的数据采集与内容发布工具，旨在为开发者提供稳定、高效的小红书全域运营解决方案。项目核心功能包括逆向工程实现的签名算法解析，支持数据采集（如用户笔记、评论等）、内容发布及KOL数据分析等功能，并且所有HTTP接口已封装完毕，简化了调用过程。此外，还提供了账号管理和素材优化等实用工具，进一步增强了其实用性。适用于需要基于小红书进行市场调研、竞品分析或者希望通过AI技术优化内容创作流程的企业和个人。请注意，此项目仅供学习交流之用，禁止任何形式的商业利用。",2,"2026-06-11 03:31:54","trending"]