小红书 (RED) URL Scheme 最全指南 - 持续更新 (附实践调用方法)
·
本文收集整理了小红书(Xiaohongshu)App的深度链接协议地址,帮助开发者实现快速跳转。所有Scheme均经真机测试验证,包含实用参数格式及调用方法说明。如果发现失效或需要补充,欢迎在评论区留言@我!
一、为什么需要小红书URL Scheme?
URL Scheme(深度链接)允许App之间实现精准跳转,可直达特定页面(如笔记详情、用户主页、话题页)。适用于:
- 社区引流:公众号/微博 -> 小红书笔记
- 活动推广:活动页 -> 小红书话题页
- 技术开发:自定义跳转逻辑、自动化测试
- 用户增长:外部拉新 -> 小红书个人主页
二、小红书 Scheme 协议清单 (最新实测)
提示:以下协议需在已安装小红书App的设备上生效。部分Scheme需配合特定参数使用。
| 分类 | Scheme路径 | 调用示例 & 重要参数 | 功能描述 | 适用版本 |
|---|---|---|---|---|
| 基础协议 | xiaohongshu:// | xiaohongshu:// | 基础协议(打开App) | iOS/Android |
| 发现/首页 | xhsdiscover:// | xhsdiscover:// | 发现页/首页(iOS) | iOS |
xhsdiscovery:// | xhsdiscovery:// | 发现页/首页(Android) | Android | |
| 用户主页 | xhsuserprofile:// | xhsuserprofile://user_id=5edfbb7a0000000001007ceb | 用户主页 | iOS/Android |
xhsdiscover://user/<user_id> | xhsdiscover://user/5edfbb7a0000000001007ceb?tab=note | 用户主页(带Tab参数) | v5.35+ | |
xhsdiscover://user/<user_id>/followers | xhsdiscover://user/5edfbb7a0000000001007ceb/followers | 用户的粉丝列表 | v5.9+ | |
xhsdiscover://user/<user_id>/collects | xhsdiscover://user/5edfbb7a0000000001007ceb/collects?tab=boards | 用户收藏内容 | v5.8+ | |
xhsdiscover://me/profile | xhsdiscover://me/profile | 我的个人资料页(编辑页面) | v4.5+ | |
| xhsdiscover://profile | xhsdiscover://profile | 个人主页(简化版) | v5.8+ | |
xhsdiscover://me/profile | xhsdiscover://me/profile | 我的个人资料页 | v4.5+ | |
| 笔记操作 | xhsdiscovery://note | xhsdiscovery://note?noteId=6483db67000000001303ab3f | 笔记详情页(Android) | Android |
xhsdiscover://detail | xhsdiscover://detail?noteId=6483db67000000001303ab3f | 笔记详情页(iOS) | iOS | |
xhsdiscover://item/<note_id> | xhsdiscover://item/6483db67000000001303ab3f?type=normal | 图文作品详情页 | v3.2+ | |
xhsdiscover://video_feed/<note_id> | xhsdiscover://video_feed/6483db67000000001303ab3f | 视频作品详情页 | v5.0+ | |
xhsdiscover://guang/<note_id> | xhsdiscover://guang/6483db67000000001303ab3f | 精选视频页 | - | |
xhsdiscover://comments/<note_id> | xhsdiscover://comments/6483db67000000001303ab3f?uid=5edfbb7a0000000001007ceb | 笔记评论区 | - | |
| 消息系统 | xhsdiscover://user/notification | xhsdiscover://user/notification | 消息通知页 | iOS |
xhsdiscover://message/collections | xhsdiscover://message/collections | 赞和收藏 | v5.0+ | |
xhsdiscover://message/comments | xhsdiscover://message/comments | 评论和@消息 | v5.0+ | |
xhsdiscover://message/strangers | xhsdiscover://message/strangers | 陌生人消息 | - | |
xhsdiscover://message/notifications | xhsdiscover://message/notifications | 系统通知 | v5.0+ | |
| 内容浏览 | xhsdiscover://home | xhsdiscover://home | 首页 | - |
xhsdiscover://home/explore | xhsdiscover://home/explore | 发现页 | v5.8+ | |
xhsdiscover://home/localfeed | xhsdiscover://home/localfeed | 同城内容 | - | |
xhsdiscover://hey_home_feed | xhsdiscover://hey_home_feed | 日常记录流 | - | |
| 社交功能 | xhsdiscover://recommend/user | xhsdiscover://recommend/user | 推荐用户列表 | v4.5+ |
xhsdiscover://recommend/contacts | xhsdiscover://recommend/contacts | 通讯录好友推荐 | v4.5+ | |
xhsdiscover://recommend/weibo | xhsdiscover://recommend/weibo | 微博好友推荐 | v4.5+ | |
| 搜索功能 | xhsdiscover://search | xhsdiscover://search/keyword=科技 | 搜索页(含关键词) | iOS |
xhsdiscover://search/recommend | xhsdiscover://search/recommend?mode=goods | 搜索推荐页 | v4.14+ | |
xhsdiscover://search_result | xhsdiscover://search_result?keyword=露营 | 搜索结果页 | iOS | |
| 商城功能 | xhsdiscover://mall | xhsdiscover://mall | 商城首页 | iOS |
xhsdiscover://home/store | xhsdiscover://home/store | 商城首页 | v5.8+ | |
xhsdiscover://page/goods/<goods_id> | xhsdiscover://page/goods/57c555b78340c36ad3875529 | 商品详情页 | - | |
xhsdiscover://spl/<spl_id> | xhsdiscover://spl/57c555b78340c36ad3875529 | 商品列表页 | - | |
xhsdiscover://spv/<spv_id> | xhsdiscover://spv/57c555b78340c36ad3875529 | 商品展示页 | v4.16+ | |
| 发布功能 | xhsdiscover://post | xhsdiscover://post?hash_tags=[{"id":"52d0deb1b4c4d655316b7d21"}] | 发布作品(相册) | v5.22+ |
xhsdiscover://post_note | xhsdiscover://post_note?ignore_draft=true | 发布笔记(忽略草稿) | v5.22+ | |
xhsdiscover://post_video | xhsdiscover://post_video | 发布视频 | - | |
xhsdiscover://notes_draft_box | xhsdiscover://notes_draft_box | 草稿箱 | - | |
| 话题功能 | xhsdiscover://topic | xhsdiscover://topic?topicId=5e9c9d5f0000000001008e19 | 话题/标签页 | iOS |
xhsdiscover://page/topics/<topic_id> | xhsdiscover://page/topics/5e9c9d5f0000000001008e19 | 新话题页 | - | |
| 设置中心 | xhsdiscover://system_settings | xhsdiscover://system_settings | 系统设置 | v5.8+ |
xhsdiscover://account/bind | xhsdiscover://account/bind | 账号绑定 | v5.0+ | |
xhsdiscover://account/bind/phone | xhsdiscover://account/bind/phone?bind_phone=138****1234 | 手机号绑定 | v5.0+ | |
xhsdiscover://dark_mode_setting | xhsdiscover://dark_mode_setting | 深色模式设置 | - | |
| 其他功能 | xhsdiscover://choose_share_user | xhsdiscover://choose_share_user | 选择分享用户 | - |
xhsdiscover://report | xhsdiscover://report?type=note | 举报功能 | - | |
xhsdiscover://list/<tag_id> | xhsdiscover://list/52d0deb1b4c4d655316b7d21 | 标签页 | v4.8+ | |
xhsdiscover://board/<board_id> | xhsdiscover://board/52d0deb1b4c4d655316b7d21 | 专辑页 | v3.2+ | |
xhsdiscover://live_audience | xhsdiscover://live_audience?room_id=123456 | 直播播放页 | - | |
xhsdiscover://hey_goal | xhsdiscover://hey_goal?clockin_count=5 | 打卡目标设置 | - |
📝 核心笔记页调用(重点):
// Android (常用)
xhsdiscovery://note?noteId=6483db67000000001303ab3f
// iOS (常用)
xhsdiscover://detail?noteId=6483db67000000001303ab3f
🧑 用户主页调用:
// 通用格式 (需替换真实user_id)
xhsuserprofile://user_id=5edfbb7a0000000001007ceb
三、技术调用方法 (代码示例)
1. Android 调用
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(Uri.parse("xhsdiscovery://note?noteId=6483db67000000001303ab3f"));
try {
startActivity(intent);
} catch (ActivityNotFoundException e) {
// 处理未安装或Scheme失效
Toast.makeText(context, "小红书未安装", Toast.LENGTH_SHORT).show();
}
2. iOS 调用 (Swift)
let schemeUrl = URL(string: "xhsdiscover://detail?noteId=6483db67000000001303ab3f")!
if UIApplication.shared.canOpenURL(schemeUrl) {
UIApplication.shared.open(schemeUrl, options: [:], completionHandler: nil)
} else {
// 跳转到App Store下载页
let appStoreUrl = URL(string: "https://apps.apple.com/cn/app/id741292507")!
UIApplication.shared.open(appStoreUrl)
}
3. Auto.js 调用 (Android 自动化)
// 跳转图文作品
function openImageNote(noteId) {
app.startActivity({
'data': `xhsdiscover://item/${noteId}?open_url=%2Fdiscovery%2Fitem%2F${noteId}%3Fapp_platform%3Dandroid%26app_version%3D8.29.0%26author_share%3D1%26ignoreEngage%3Dtrue%26share_from_user_hidden%3Dtrue%26type%3Dnormal%26xsec_source%3Dapp_share%26xsec_token%3DBBUg8SvmP53lWTF7qK1buhZdglChCZhiNhfOotmm19UWQ%253D%26xhsshare%3DCopyLink%26appuid%3D671e6b46000000001d021e13%26apptime%3D1730047736&position=to_note-nav-btn&browser=chrome&launch_from=h5_note_detail&launch_strategies=android_other_urlschema_jumpinstallurl&click_point=26417&launch_strategy=wx_tag_unReady&exp_groups=m_fmp_enhance_stream&web_id=fcb67cf03d26f8ff0167711a10aab6d4&searchengine=&launch_method=method_url_schema`
});
}
// 跳转视频作品
function openVideoNote(noteId) {
app.startActivity({
'data': `xhsdiscover://video_feed/${noteId}?open_url=%2Fdiscovery%2Fitem%2F${noteId}%3Fapp_platform%3Dandroid%26app_version%3D8.29.0%26author_share%3D1%26ignoreEngage%3Dtrue%26share_from_user_hidden%3Dtrue%26type%3Dvideo%26xsec_source%3Dapp_share%26xsec_token%3DBB7flhT317-lEiZkFKJbkVnoUI03b1VqatsoVwQ0Hj2kI%253D%26xhsshare%3DCopyLink%26shareRedId%3DOD0zRTlHOD82NzUyOTgwNjdHOTk1Sjc8%26apptime%3D1730047323&position=&browser=chrome&launch_from=h5_note_detail&launch_strategies=android_other_urlschema_jumpinstallurl&launch_method=auto_launch_app&launch_strategy=auto_launch_app&web_id=fcb67cf03d26f8ff0167711a10aab6d4&searchengine= `
});
}
// 使用示例
let testNoteId = "6483db67000000001303ab3f";
openImageNote(testNoteId); // 打开图文笔记
// openVideoNote(testNoteId); // 打开视频笔记
参数说明表
| 参数名称 | 必填 | 示例值 | 作用说明 |
|---|---|---|---|
| noteId | 是 | 6483db67000000001303ab3f | 笔记唯一标识 |
| type | 是 | normal(图文)/video(视频) | 内容类型标识 |
| xsec_token | 是 | BBUg8SvmP53lWTF7qK1buhZdglCh... | 授权令牌(动态变化) |
| app_platform | 是 | android | 平台标识 |
| app_version | 是 | 8.29.0 | 客户端版本 |
| author_share | 是 | 1 | 作者分享标识 |
| xhsshare | 是 | CopyLink | 分享渠道标识 |
| shareRedId | 视频专属 | OD0zRTlHOD82NzUyOTgwNjdHOTk1Sjc8 | 视频加密标识 |
四、注意事项 & 避坑指南
- 参数格式:
noteId和userId通常为24位Hex字符串(如6483db67000000001303ab3f),切勿省略。 - 平台差异:iOS与Android部分Scheme前缀不同(如
xhsdiscover://vsxhsdiscovery://)。 - 版本兼容:新版小红书可能废弃旧Scheme,需定期测试更新。
- 未安装处理:必须增加异常捕获,引导用户下载App。
- URL编码:关键词含中文时需Encode(如
科技→%E7%A7%91%E6%8A%80)。
五、待补充 & 失效反馈
以下场景Scheme持续寻找中:
- 发布笔记页
- 商品详情页
- 私信聊天页
- 网页通用跳转协议
如果发现本文Scheme失效,或你有未被记录的协议,欢迎在评论区留言!
(格式:功能描述 + Scheme地址 + 参数示例,例如:“商城优惠券页:xhsdiscover://coupon?tab=1”)
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)