Skip to main content
Glama
iTraceur

wechat-mp-search

by iTraceur
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

dsh-wechat-mp-search

npm License: MIT

deepseek-harness (dsh) 插件，同时提供同构的 MCP server 入口：零配置抓取搜狗微信搜索（weixin.sogou.com），用于检索微信公众号文章并抓取正文。

两种分发形态共享同一套核心逻辑（src/sogou.ts），工具名、参数与返回字段完全一致：

  • dsh 插件（src/index.ts）：进程内 Cordis 插件，随宿主 dsh 运行时加载；

  • MCP server（src/mcp-server.ts）：标准 Model Context Protocol stdio server，供 Claude Code、Cursor、Codex 等任意 MCP 客户端使用。

工具

工具名

参数

说明

weixin_search

query: string（必填）、page?: number（默认 1）

搜索单页结果，返回 { results, blocked }。

weixin_search_all

query: string（必填）、max_pages?: number（默认 10）

按页翻页搜索，直到达到页数上限或命中反爬拦截；max_pages 会被插件配置的硬上限（maxPages）截断。

get_weixin_article_content

real_url: string（必填）、referer?: string

抓取文章正文纯文本；失败时返回 获取文章内容失败: ... 字符串而非抛异常。

weixin_search/weixin_search_all 返回的每条结果字段：title、link（搜狗跳转链接）、real_url（还原后的微信公众号真实链接，解析失败为空串）、publish_time、page。

Related MCP server: WeChat Article Reader MCP Server

反爬 / 限流策略

本插件进行了四项反爬增强，均可通过插件配置调整：

  1. 会话级 cookie jar：同一次搜索会话内（一次 weixin_search 调用及其后续链接解析请求）共享并累积 Set-Cookie，使后续请求携带前序请求获得的 cookie。

  2. 请求间限速抖动：链接解析之间使用 linkDelayMs + [0, linkDelayJitterMs) 随机抖动延迟；weixin_search_all 翻页之间使用 pageDelayMs + [0, pageDelayJitterMs) 随机抖动延迟。

  3. 反爬重试：命中反爬验证（响应体或跳转后 URL 出现反爬特征）时，重建一个全新会话（全新 cookie jar）重试一次；仍失败才判定为 blocked: true。

  4. max_pages 硬上限：weixin_search_all 的 max_pages 参数无法突破插件配置项 maxPages（默认 30）。

配置项

配置项

默认值

说明

requestTimeoutMs

15000

单次 HTTP 请求超时（毫秒）。

maxOutputBytes

8000000

响应体最大字节数；流式读取达到上限即停止下载并按字符边界截断。

linkDelayMs / linkDelayJitterMs

200 / 400

链接解析之间的最小延迟与随机抖动上限。

pageDelayMs / pageDelayJitterMs

1000 / 1000

翻页之间的最小延迟与随机抖动上限。

retryDelayMs

2500

命中反爬后重建会话重试前的最小延迟。

maxPages

30

weixin_search_all 的 max_pages 硬上限。

各数值配置项均有下界（如 requestTimeoutMs >= 1，延迟类 >= 0）：dsh 形态下非法值会在插件加载时被校验拒绝；MCP 形态（不经过配置校验）会将非法值（负数、NaN 等）回退为默认值。

安装

dsh 插件

# 本地路径安装
dsh plugin --profile <profile-name> add ${workspace}/dsh-wechat-mp-search

# 发布到 npm 后
dsh plugin --profile <profile-name> add dsh-wechat-mp-search

MCP server（任意 MCP 客户端）

本包的默认可执行入口即 MCP stdio server。

本地路径使用（无需发布到 npm）：先用 npm install && npm run build 生成 lib/，然后在支持 MCP 的客户端中添加：

{
  "mcpServers": {
    "wechat-mp-search": {
      "command": "node",
      "args": ["${workspace}/dsh-wechat-mp-search/lib/mcp-server.js"]
    }
  }
}

Claude Code 也可以一行命令添加：

claude mcp add wechat-mp-search -- node ${workspace}/dsh-wechat-mp-search/lib/mcp-server.js

修改源码后重新 npm run build 即生效。频繁迭代可在项目目录执行 npm link，之后配置直接写 "command": "dsh-wechat-mp-search"。

发布到 npm 后：

{
  "mcpServers": {
    "wechat-mp-search": {
      "command": "npx",
      "args": ["-y", "dsh-wechat-mp-search"]
    }
  }
}

或全局安装后直接使用命令：

npm install -g dsh-wechat-mp-search
# 客户端配置: { "command": "dsh-wechat-mp-search" }

MCP 入口零配置运行，各反爬参数使用上文默认值；需要自定义时可在 dsh 形态下通过插件 config 调整。

开发

npm install
npm run build       # tsc -p tsconfig.json
npm run typecheck   # tsc --noEmit
npm test            # vitest run

peerDependencies 中的 @deepseek-ai/cordis、@deepseek-ai/dsh-tools 由宿主 dsh 运行时提供。 本仓库的 .npmrc 已将 registry 指向官方 https://registry.npmjs.org/，因为这几个包 （含其自身的 @deepseek-ai/dsh-llm、@deepseek-ai/dsh-session 等传递 peer 依赖）已在公网 npm 发布对应版本，可直接 npm install；若你的环境配置了指向其他镜像源的全局 registry， 请临时使用 --registry=https://registry.npmjs.org/ 或本仓库自带的 .npmrc。

免责声明

仅学习研究使用，请控制请求频率，遵守搜狗 / 微信与相关法规。目标站点接口变更可能导致解析逻辑失效

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

UpdatingMaintainers
UpdatingResponse time
–Release cycle
0Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • ReadGZH

    Read WeChat public account articles via MCP. 99.89% anti-scraping success, 50-87% token compression.

  • Aginx Browser

    Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.

  • Jina Reader

    Jina AI Reader/Search MCP — turn any URL into clean LLM-ready markdown, plus web search.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/iTraceur/dsh-wechat-mp-search'

If you have feedback or need assistance with the MCP directory API, please join our Discord server