sherlock-mcp 1.1.1 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -13,8 +13,8 @@
13
13
  生产环境先以**与 Youmai 后端相同的运行用户、Python、缓存目录和网络环境**执行预热,再配置 MCP:
14
14
 
15
15
  ```bash
16
- npx -y sherlock-mcp@1.1.1 --prepare
17
- npx -y sherlock-mcp@1.1.1
16
+ npx -y sherlock-mcp@2.0.0 --prepare
17
+ npx -y sherlock-mcp@2.0.0
18
18
  ```
19
19
 
20
20
  正常启动立即完成协议握手和工具发现;`--prepare` 只安装及检查运行环境,不查询社交账号。未经预热时第一次搜索也会准备依赖,可能超过客户端等待时间,因此生产部署应提前预热。
@@ -31,8 +31,8 @@ node dist/cli.cjs
31
31
  打包后可在其他目录验证本地安装包:
32
32
 
33
33
  ```bash
34
- npx -y --package=/absolute/path/sherlock-mcp-1.1.1.tgz sherlock-mcp --prepare
35
- npx -y --package=/absolute/path/sherlock-mcp-1.1.1.tgz sherlock-mcp
34
+ npx -y --package=/absolute/path/sherlock-mcp-2.0.0.tgz sherlock-mcp --prepare
35
+ npx -y --package=/absolute/path/sherlock-mcp-2.0.0.tgz sherlock-mcp
36
36
  ```
37
37
 
38
38
  ## Youmai 配置与生产迁移
@@ -41,16 +41,16 @@ npx -y --package=/absolute/path/sherlock-mcp-1.1.1.tgz sherlock-mcp
41
41
  |---|---|
42
42
  | 名称 | Sherlock |
43
43
  | 连接方式 | stdio |
44
- | 启动命令 | `npx -y sherlock-mcp@1.1.1` |
44
+ | 启动命令 | `npx -y sherlock-mcp@2.0.0` |
45
45
  | 绑定 | 身份识别 |
46
46
  | 审批 | 跟随会话;三个工具均声明只读 |
47
- | 网络出口 | 沿用智能体授权代理,由 Youmai 注入进程环境 |
47
+ | 网络出口 | 使用 Youmai 系统默认出口;未设置默认代理则直连 |
48
48
 
49
49
  发布流程为构建、测试、`npm pack`、在干净目录验证安装包,再按组织的发布流程发布到 npm。生产只需取得相同版本的 npm 包,预热并创建或更新连接、绑定;不依赖开发机源码路径,也不需要复制虚拟环境。多个后端实例分别预热;容器部署在实际执行 MCP 的后端容器内准备依赖。
50
50
 
51
51
  Youmai 的智能体配置导出只保存 MCP 资源 ID,不附带 npm/Python 安装内容,也不导出代理。跨实例需要创建目标连接并重新绑定;系统提示词、查询指南和报告模板也要同步到实际智能体工作目录,不能只修改仓库模板。
52
52
 
53
- 1.1.0 新增的三平台查询由本 MCP 的 Python worker 独立执行,不需要 Youmai 内置 `social_profile_search`,也不需要把 Youmai 的搜索代码或本机源码复制到生产。保留宿主已有的目标来源校验。
53
+ 三平台查询由本 MCP 的 Python worker 独立执行,不需要 Youmai 内置 `social_profile_search`,也不需要把 Youmai 的搜索代码或本机源码复制到生产。保留宿主已有的目标来源校验。
54
54
 
55
55
  相关模板位于 `../youmai/prompts/intelx/`,保留现有 dp 和 IntelX 连接。Sherlock 不需要业务 API Key。
56
56
 
@@ -61,7 +61,7 @@ Youmai 的智能体配置导出只保存 MCP 资源 ID,不附带 npm/Python
61
61
  | `SHERLOCK_MCP_PYTHON` | 可选,Python 可执行文件路径;不接受 shell 命令或附加参数。默认按 PATH 检测 `python`、`python3` |
62
62
  | `SHERLOCK_MCP_CACHE_DIR` | 可选,独立 Python 依赖缓存根目录 |
63
63
  | `AGENTHUB_USER_DATA` | Youmai 可注入;未指定独立缓存时使用其 `sherlock-mcp/` 子目录 |
64
- | `SHERLOCK_SEARXNG_URL` | 可选,自建 SearXNG 基址(启用 JSON 输出);未设置时使用公开 Bing RSS 搜索,无需 API 密钥。配置后只使用 SearXNG,不静默换源。所有请求沿用同一个授权代理,故该服务必须能从代理出口访问 |
64
+ | `SHERLOCK_SEARXNG_URL` | 可选,自建 SearXNG 基址(启用 JSON 输出);仅在 `mode="web_search"` 时生效;未设置时使用公开 Bing RSS 搜索,无需 API 密钥。配置后只使用 SearXNG,不静默换源。所有请求沿用同一个授权代理,故该服务必须能从代理出口访问 |
65
65
  | `SHERLOCK_MCP_INDEX_URL` | 可选,安装 wheel 的 Python 包索引,默认 `https://pypi.org/simple`;仍强制校验锁定文件中的哈希 |
66
66
  | `HTTPS_PROXY`、`HTTP_PROXY`、`ALL_PROXY` | 可选,查询优先使用 HTTPS、HTTP、ALL 的第一个已设置值,小写同名变量优先。支持 HTTP(S)、SOCKS5、SOCKS5H;Youmai 的其他节点协议由平台转为 HTTP relay |
67
67
 
@@ -105,27 +105,29 @@ Youmai 的智能体配置导出只保存 MCP 资源 ID,不附带 npm/Python
105
105
 
106
106
  ### `social_profile_search`
107
107
 
108
- 通过同一个 stdio MCP 查询 Facebook、Twitter/X、LinkedIn 的公开账号候选;与 `sherlock_search` 的站点规则检测分开记录。Facebook 和 LinkedIn 因登录页误报不在固定的 Sherlock 规则中,本工具使用公开网页搜索补充,不能把它们强传给 `sherlock_search.sites`。
108
+ 通过同一个 stdio MCP 默认直接探测 Facebook、Twitter/X、LinkedIn 的固定用户名主页,与 Sherlock 的规则检测分别记录。不依赖搜索引擎是否收录,也不需要 Youmai 新增内置工具。Facebook 与 LinkedIn 不在固定的 Sherlock 规则中,不能强传给 `sherlock_search.sites`。
109
109
 
110
110
  ```json
111
111
  {
112
112
  "username": "example_user",
113
+ "mode": "username",
113
114
  "platforms": ["facebook", "twitter", "linkedin"],
114
- "limit_per_platform": 3,
115
115
  "fetch_profiles": true,
116
116
  "timeout_seconds": 10,
117
117
  "total_timeout_seconds": 60
118
118
  }
119
119
  ```
120
120
 
121
- - `username` 必填,1–100 个 ASCII 字母、数字、下划线、点或连字符,可带前导 `@`。仅使用用户提供或有明确来源的用户名。
122
- - 其他参数可省略,默认逐一搜索三个平台;`x` / `Twitter/X` 为 Twitter 别名,平台名称忽略大小写。每个平台最多 1–3 个候选,优先精确用户名;不生成虚构搜索命中。
123
- - 默认直接使用 Bing 的公开 RSS 搜索,无需 Youmai 后端或 SearXNG;也可通过环境变量接入自建 SearXNG。公开搜索服务可能限流、屏蔽查询或不收录目标,并非稳定性承诺。
124
- - 返回每个平台的 `query`、`checked_at`、`search_status` 和候选列表;候选保留来源 URL、标题、摘要、`exact_handle_match`、`page_status` 与读取时间。仅允许平台主页路径,排除帖子、登录、分享和伪造域名;重定向必须仍指向同一主页。
125
- - `candidates_found` 为搜索候选;`no_matches` 是本次公开搜索未匹配,不证明账号不存在。`failed` 为查询失败;403、429、登录墙、验证码、超时均保留为未核验。
126
- - `fetched` 只表示读到公开文本,不确认账号存在性或归属;所有 `identity_status` 固定为 `unverified`。相同用户名、搜索摘要或 HTTP 200 均不能单独确认自然人身份。
127
- - 整次时限到达时保留已收到的平台记录,为其余平台补 `reason=total_timeout`、`checked_at=null`,不伪装三平台已查完。连接关闭或取消会终止 worker。结果提供 JSON 文本及 `structuredContent`。
128
- - 不接收业务参数中的代理 URL、Youmai 令牌或浏览器登录态。通过宿主环境获取授权代理,搜索和页面读取沿用同一路由,忽略 `NO_PROXY`,失败不直连。原始传输错误和凭据不进入结果。
121
+ - `username` 必填,1–100 个 ASCII 字母、数字、下划线、点或连字符,可带前导 `@`。仅使用用户提供或有明确来源的用户名。Twitter 限 1–15 个字母、数字、下划线;其他不受支持的输入返回 `ILLEGAL`,不发送请求。
122
+ - `mode="username"` 为默认值,分别请求 `https://www.facebook.com/<username>`、`https://x.com/<username>`、`https://www.linkedin.com/in/<username>`;`x` / `Twitter/X` 为 Twitter 别名。重定向仅允许 HTTPS 同一平台的同一主页,不跟随登录、验证码或外站跳转。
123
+ - 返回每个平台的 `method=direct_username`、`status`、目标 `url`、`http_status`、`checked_at`、`page_status`、`reason` 与候选列表。仅在主页 URL、非通用标题和公开个人主页元数据一致时返回 `CLAIMED`;HTTP 200、URL 回显或通用网页不能单独构成命中。
124
+ - `AVAILABLE` 仅表示本次 HTTP 404/410 未检测到,不证明永久不存在或一定可注册。登录墙、验证码及网站拦截返回 `WAF`;超时、代理失败、无明确主页证据返回 `UNKNOWN`。受限页面不会被计为账号不存在,工具不绕过登录和验证。
125
+ - `fetch_profiles=false` 在直接模式下仍请求主页并进行存在性判断,只省略 `page_excerpt`;`true` 最多返回 4,000 字符公开文本。所有 `identity_status` 始终为 `unverified`,同名账号不能直接归属于自然人。
126
+ - 显式 `mode="web_search"` 保留旧版公开搜索补充:默认 Bing RSS,可配置 `SHERLOCK_SEARXNG_URL`。每个平台 `limit_per_platform=1..3`,优先精确用户名;`no_matches` 仅表示索引中未匹配,不能替代直接主页探测。搜索服务的无关结果、漏收录和限流均可能造成漏检。
127
+ - 总时限到达后保留已完成记录,缺失平台返回 `UNKNOWN`、`reason=total_timeout`、`checked_at=null`。顶层 `status=failed/partial` 表示请求或证据未完整,不能当作没有账号。关闭或取消会终止 worker,结果提供 JSON 文本及 `structuredContent`。
128
+ - 不接收业务参数中的代理 URL、Youmai 令牌或浏览器登录态。所有请求使用同一宿主配置出口;配置代理时忽略 `NO_PROXY`,失败不切为直连。异常正文与凭据不进入结果。
129
+
130
+ 2.0.0 将三平台默认行为从搜索收录查询改为直接用户名探测;需要旧行为的调用方须显式指定 `mode="web_search"`。更新实际提示词、指南和 MCP 命令后重连。当前 Youmai 的「身份识别」「社工数据查询」已移除专用路由绑定,生产同步时也应在管理页面移除该旧绑定并使用系统默认出口;已有会话副本需开启新会话或在空闲时重启以清除旧配置。
129
131
 
130
132
  ## 版本与规则
131
133