huyou-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
狐友 MCP(huyou-mcp)
用 MCP 帮你逛搜狐「狐友」的校园圈子,看校友发了什么,每条都给出可直接点开的帖子链接。
已经做到的:
免登录读取圈子动态、帖子详情、评论与楼中楼;
只挑「有实用信息」的帖子(校园跑技巧、哪门课老师好、真题资料、办事流程、失物二手……), 抱怨骂人、找对象、打探钱、八卦、广告、水贴不进邮箱;
汇总成邮件推送到 QQ 邮箱;
评论 / 点赞的代码也写好了,默认关闭(扫码登录后可开)。
站点:https://hy.sns.sohu.com/?tab=circle(狐友 Web 版,搜狐的校园/兴趣社区)
一、先调研:有没有现成能用的?
结论:没有现成的狐友工具,狐友这一层必须自己实现;底层全部复用成熟件。
调研方向 | 结果 |
现成 MCP(狐友 / 搜狐社交) | 没有。npm 上 |
官方 API | 没有。狐友只对 App/小程序开放,Web 端是 Nuxt 3 SPA 直接调内部 JSON 接口 |
通用浏览器自动化 MCP(如 Playwright MCP、Chrome DevTools MCP) | 可以做「点开网页看一眼」,但要长期无人值守地跑,就得常驻浏览器 + 每次让模型读页面,慢、贵、易碎,而且它不会自己发摘要邮件 |
社区逆向资料 | 只覆盖 App 端(unidbg 复刻 SO 里的 |
可复用的成熟件 | MCP 官方 Python SDK( |
所以本项目的定位是:只写「狐友接口 + 业务编排」这一层,其余不重复造轮子。
Related MCP server: shuiyuan-mcp-lite
二、实现原理:Web 端接口逆向结果
1. 接口与签名
网页数据全部走
https://cs-ol.sns.sohu.com(另有op-/dm-两个网关)。每个业务请求都要签名,等价于前端 bundle 里的
Hi():参数(GET 放 query / POST 放 form)里补 flyer、appid、app_key_vs pairs = [f"{k}={v}" ...] + [f"s-nonce={s-nonce}", f"S-VS={S-VS}"] sig = md5("".join(sorted(pairs)) + app_key)请求头:
S-PID(hyuid)S-PPID(pchypp)S-VSS-CID/gid=gidinftoken(pchytk)P-APPIDappids-nonceflyer。gidinf(设备号)不是登录态,访问一次https://passport.sohu.com就会下发,程序启动时自动领。签名实现见
crypto.py,用 Node 版「前端逻辑复刻」生成的固定向量做交叉校验(tests/test_crypto.py)。
2. 用到的接口
用途 | 方法 & 路径 | 关键参数 | 是否需要登录 |
圈子分类 |
| – | 否 |
分类下的圈子 |
|
| 否 |
搜圈子 |
|
| 否 |
圈子动态列表 |
|
| 否 |
动态详情 |
|
| 否 |
评论列表 |
|
| 否 |
楼中楼回复 |
|
| 否 |
发评论 |
|
| 是 |
评论点赞 |
|
| 是 |
扫码登录 |
|
| – |
当前用户 |
|
| 是 |
3. 两个关键细节
帖子链接:前端把详情做成弹窗,深链就是
https://hy.sns.sohu.com/?feedDetail=<feed_id>,点开直接是那条动态的详情。发帖时间:「新发」列表里每条动态的
score就是发帖时间的毫秒时间戳(热门/精华排序的 score 是复合打分,不能当时间用,代码里已做区分)。
评论同样是免登录可读的:/v8/comment/list 一次就带回一级评论 + 每条的 replies.list(楼中楼),
字段有 userName、content、timeId(毫秒)、likeCount、liked、replyCount、replyUserName。
列表里若带 sourceRegion 就是评论者 IP 属地(比如「北京」)。狐友AI助手的自动回复会带 AI 字样,摘要里已过滤。
三、现在能做什么
MCP 工具(16 个)
浏览类(不需要登录):
工具 | 作用 |
| 圈子分类 |
| 校园分类下的高校圈子 |
| 按学校名搜圈子 |
| 圈子动态(新发/新回/热门/精华,带游标翻页,每条含链接) |
| 单条动态详情 |
| 评论列表(含楼中楼回复、comment_id,可用于回复/点赞) |
| 某条评论下的全部楼中楼回复(分页) |
| 配置里关注的圈子 |
推送类(只发「有实用信息」的帖子,见下方筛选口径):
工具 | 作用 |
| 两步走第一步:列出本轮新帖(带规则判定 |
| 两步走第二步:按你挑的 |
| 一键:抓新帖 → 规则过滤 → 发 QQ 邮件; |
账号/写操作类:
工具 | 说明 |
| 扫码登录(二维码落盘成图片路径) |
| 评论 / 给评论点赞,默认关闭,需 |
推送筛选口径(写进了 MCP instructions,模型每次都会看到)
用户明确要求:只发有实用信息的帖子。
✅ 发:校园跑怎么更省事、体测技巧;哪门课老师好/不好、给分点名选课建议;考试真题复习资料、 绩点保研考研实习招聘;办事流程(校医院、户籍、报销、校园卡、报修、电费网费); 食堂外卖快递、失物招领、二手闲置等具体信息;讲座比赛社团活动、学校通知政策。
❌ 不发:纯抱怨和情绪发泄、骂人脏话;与学习/校园无关的无意义提问(找女朋友、大家有多少钱); 八卦吃瓜挂人;抽奖拉群广告商单;几个字的纯水贴。
⚠️ 判不准时倾向不发。
实现分两层:filters.py 规则初筛(关键词打分,保证命令行/定时任务单独跑也有效),
MCP 里再由模型用 huyou_new_feeds 复核一遍。今天海大圈实测:6 小时 54 条新帖 → 36 条有用(过滤 18 条)。
命令行
huyou-mcp smoke # 端到端自检:搜圈→动态→详情→评论
huyou-mcp circles --category campus --limit 10 # 校园圈子
huyou-mcp circles --search 中国海洋大学 # 搜学校圈子
huyou-mcp feeds 874712662708262400 --sort new # 看新帖(打印帖子链接)
huyou-mcp feed <feed_id> # 看详情(含配图 URL)
huyou-mcp comments <feed_id> # 看评论
huyou-mcp digest --dry-run # 渲染今日摘要到 data/outbox(不发信)
huyou-mcp digest # 抓 + 按筛选口径过滤 + 发 QQ 邮件
huyou-mcp mail-test # 发测试信,验证 QQ 授权码
huyou-mcp login # 扫码登录(写操作前需要)
huyou-mcp serve # 以 MCP server 方式跑(stdio)四、安装
已在本机 Windows + Python 3.12 验证。
cd <你的目录>\huyou_auto
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .
copy config.example.toml config.toml # 之后按需改
.\.venv\Scripts\python.exe -m huyou_mcp.cli smoke单元测试:
.\.venv\Scripts\python.exe -m pytest -q注册到 MCP 客户端
DSH / Claude Desktop / Cursor 这类客户端都吃同样的结构(命令写绝对路径):
{
"mcpServers": {
"huyou": {
"command": "<你的目录>\\huyou_auto\\.venv\\Scripts\\python.exe",
"args": ["-m", "huyou_mcp.cli", "serve"],
"cwd": "<你的目录>\\huyou_auto"
}
}
}五、推送配置(当前:随叫随刷)
现状:没有注册任何计划任务。你想刷的时候说一句「刷一下狐友」,AI 就调
huyou_alumni_digest抓新帖并发 QQ 邮件;也可以自己跑huyou-mcp digest。 已推送过的帖子记录在data/state.json,重复刷只会推新的。
当前 config.toml(凭证在本地文件里,.gitignore 已排除,不进版本库):
[watch]
schools = ["中国海洋大学"] # 自动搜圈子并缓存 id(海大 = 874712662708262400)
circle_ids = [] # 也可以直接写圈子 id
sorts = ["new"] # new 新发 / reply 新回 / hot 热门 / elite 精华
per_circle = 20 # 每页条数
max_pages_per_circle = 10 # 最多翻几页(10 页 ≈ 200 条,覆盖活跃圈一天)
max_age_hours = 36 # 只推这个时间窗内的帖子
hot_comment_threshold = 2 # 评论数 ≥ 2 算「有讨论」,邮件里重点展示
skip_top = false # true = 跳过置顶(多是圈公告/商单)
[mail]
enabled = true
user = "发件QQ号@qq.com"
password = "QQ邮箱授权码" # 不是登录密码
to = ["收件邮箱@qq.com"]
max_posts = 120 # 一封邮件最多展示多少条
only_hot = false # true = 只推「有讨论」的帖子
include_comments = true # 给「有讨论」的帖子附上评论
comment_preview_count = 3 # 每条帖子附几条评论
[filter]
enabled = true # 只推有实用信息的帖子(抱怨/骂人/找对象/打探钱/八卦/广告/水贴都过滤)
min_score = 2 # 2=较宽(命中一个实用主题就推);3=更严;1=更宽
extra_useful = [] # 额外「一定推」的词,例如 ["实习","考研"]
extra_noise = [] # 额外「一定不推」的词,例如 ["二手","失物"]常用命令:
huyou-mcp digest # 抓新帖 + 发邮件(AI 就是调这个)
huyou-mcp digest --dry-run # 只渲染,不发信、不更新已读
huyou-mcp mail-test # 发一封测试信,验证授权码对不对授权码获取:
mail.qq.com→ 设置 → 账户 → 开启「POP3/SMTP 服务」→ 生成授权码。改完
password后跑一次huyou-mcp mail-test,收到就说明通了。授权码等于邮箱的发送权限,别提交到 git、别贴到公开地方;怀疑泄露就去 QQ 邮箱「删除授权码」再生成新的。
想改回定时推送:
scripts\daily-digest.ps1+schtasks一行即可(脚本已就绪,日志写data\digest.log)。
推送量怎么调(以海大圈实测为准)
中国海洋大学圈(874712662708262400)一天大约 160~200 条新帖,其中约 70 条有评论。
默认一封信 = 「有讨论」卡片最多 20 张 + 「其他动态」紧凑列表,合计不超过 max_posts。
想要的效果 | 改法 |
只要有人讨论的 |
|
邮件更短 | 调小 |
想连更早的也补推 | 临时把 |
连置顶公告也不要 |
|
只想看某个时段 | 想刷的时候再让 AI 调一次, |
六、下一阶段:评论 / 点赞
代码已经写好,只是默认关着:
huyou-mcp login(或 MCP 里huyou_login_qrcode+huyou_login_poll)用狐友 App 扫码,登录态存data/cookies.json;config.toml里[write] enabled = true;之后
huyou_post_comment/huyou_like_comment才可用。
注意两点:
发评论接口带风控(前端在失败后会用
vcode_token重试一次),首次真实发评建议手动盯一次;这是拿真实账号操作,建议低频、内容自己把关,别当刷量工具用。
七、目录结构
src/huyou_mcp/
constants.py 接口常量(网关、App 凭证、路径、链接模板)—— 搜狐改版先改这里
crypto.py 签名:nonce + md5(sig)
session.py 带签名的会话、cookie 持久化、gidinf 引导、代理处理
models.py Circle / Feed / Comment 归一化
api.py 业务接口(圈子、动态、详情、评论、评论点赞、扫码登录校验)
auth.py 扫码登录 + 从浏览器导入 cookie
filters.py 筛选规则:实用主题 / 噪音主题打分
service.py 编排:关注圈子解析、采集去重、筛选、摘要渲染、已读状态
mailer.py QQ 邮箱 SMTP
server.py MCP 工具层(工具定义 + 筛选口径写进 instructions)
cli.py 命令行 / 计划任务入口
tests/ 单测 34 个:签名交叉校验、模型归一化、筛选规则
_recon/ 逆向时的探测脚本(下载的第三方 bundle / 页面快照 / 接口样本不入库)八、已知限制
非官方接口。搜狐改版可能导致签名或参数变化,
_recon/里的脚本可以重新抓 bundle、比对路径。只读浏览完全不需要账号;写操作一旦开启就是真实账号行为,风险自负。
data/cookies.json等于账号凭证,别提交、别外发(.gitignore已排除)。仓库里不带任何真实凭证:
config.toml、data/全部被忽略,模板见config.example.toml。
九、免责声明
仅供个人学习与自用阅读,不提供任何绕过登录、批量刷量或商业化能力。 接口来自前端逆向,与搜狐官方无关;使用产生的任何后果由使用者自负。 抓到的帖子内容版权属于原作者,请勿转载或用于训练/发布。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Weibo (微博) data without login: hot searches, posts by keyword, comments, creator profiles.
Read public sources and manage a smry library, feeds, notes, highlights, files, and page monitors.
China news (EN/ZH), Weibo 微博/Baidu 百度/Zhihu 知乎 hot lists and deletion watch from public data.
China news (EN/ZH), Weibo 微博/Baidu 百度/Zhihu 知乎 hot lists and deletion watch from public data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search and retrieve Fudan University's Tree Hole community posts, course reviews, and campus discussions, including browsing tags and divisions, from off campus via WebVPN, and to summarize findings through natural language.2GPL 3.0
- AlicenseAqualityCmaintenanceEnables read-only access to the SJTU Shuiyuan community, allowing users to search topics, read posts and user profiles, and list categories and tags through MCP.5MIT
- AlicenseAqualityBmaintenanceEnables read-only querying of eight campus services through independent local MCP adapters: mailbox search, reading and attachment download, Blackboard courses, academic-system terms, timetable and grades, library loans and navigation, teaching-office notices, the Nan7 market listings, course-review community ratings, and the campus data dashboard. Credentials and sessions remain on the user's own device, encrypted with Windows DPAPI, and nothing is submitted, registered, or booked on the user's behalf.71MIT
- AlicenseNot gradedqualityCmaintenanceEnables reading homework requirements, questions, and attachment text, along with querying course schedules, materials, and deadlines from the Xuexitong platform.MIT