sherlock-mcp 1.1.0 → 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 +20 -18
- package/dist/cli.cjs +19 -19
- package/package.json +1 -1
- package/python/social_profiles.py +136 -8
package/README.md
CHANGED
|
@@ -13,8 +13,8 @@
|
|
|
13
13
|
生产环境先以**与 Youmai 后端相同的运行用户、Python、缓存目录和网络环境**执行预热,再配置 MCP:
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
npx -y sherlock-mcp@
|
|
17
|
-
npx -y sherlock-mcp@
|
|
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-
|
|
35
|
-
npx -y --package=/absolute/path/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.0.tgz sherlock-mcp
|
|
|
41
41
|
|---|---|
|
|
42
42
|
| 名称 | Sherlock |
|
|
43
43
|
| 连接方式 | stdio |
|
|
44
|
-
| 启动命令 | `npx -y sherlock-mcp@
|
|
44
|
+
| 启动命令 | `npx -y sherlock-mcp@2.0.0` |
|
|
45
45
|
| 绑定 | 身份识别 |
|
|
46
46
|
| 审批 | 跟随会话;三个工具均声明只读 |
|
|
47
|
-
| 网络出口 |
|
|
47
|
+
| 网络出口 | 使用 Youmai 系统默认出口;未设置默认代理则直连 |
|
|
48
48
|
|
|
49
49
|
发布流程为构建、测试、`npm pack`、在干净目录验证安装包,再按组织的发布流程发布到 npm。生产只需取得相同版本的 npm 包,预热并创建或更新连接、绑定;不依赖开发机源码路径,也不需要复制虚拟环境。多个后端实例分别预热;容器部署在实际执行 MCP 的后端容器内准备依赖。
|
|
50
50
|
|
|
51
51
|
Youmai 的智能体配置导出只保存 MCP 资源 ID,不附带 npm/Python 安装内容,也不导出代理。跨实例需要创建目标连接并重新绑定;系统提示词、查询指南和报告模板也要同步到实际智能体工作目录,不能只修改仓库模板。
|
|
52
52
|
|
|
53
|
-
|
|
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
|
|
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
|
|
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
|
-
-
|
|
123
|
-
-
|
|
124
|
-
-
|
|
125
|
-
- `
|
|
126
|
-
- `
|
|
127
|
-
-
|
|
128
|
-
- 不接收业务参数中的代理 URL、Youmai
|
|
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
|
|