sherlock-mcp 1.0.0 → 1.1.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.0.0 --prepare
17
- npx -y sherlock-mcp@1.0.0
16
+ npx -y sherlock-mcp@1.1.0 --prepare
17
+ npx -y sherlock-mcp@1.1.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.0.0.tgz sherlock-mcp --prepare
35
- npx -y --package=/absolute/path/sherlock-mcp-1.0.0.tgz sherlock-mcp
34
+ npx -y --package=/absolute/path/sherlock-mcp-1.1.0.tgz sherlock-mcp --prepare
35
+ npx -y --package=/absolute/path/sherlock-mcp-1.1.0.tgz sherlock-mcp
36
36
  ```
37
37
 
38
38
  ## Youmai 配置与生产迁移
@@ -41,15 +41,17 @@ npx -y --package=/absolute/path/sherlock-mcp-1.0.0.tgz sherlock-mcp
41
41
  |---|---|
42
42
  | 名称 | Sherlock |
43
43
  | 连接方式 | stdio |
44
- | 启动命令 | `npx -y sherlock-mcp@1.0.0` |
44
+ | 启动命令 | `npx -y sherlock-mcp@1.1.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
+ 1.1.0 新增的三平台查询由本 MCP 的 Python worker 独立执行,不需要 Youmai 内置 `social_profile_search`,也不需要把 Youmai 的搜索代码或本机源码复制到生产。保留宿主已有的目标来源校验。
54
+
53
55
  相关模板位于 `../youmai/prompts/intelx/`,保留现有 dp 和 IntelX 连接。Sherlock 不需要业务 API Key。
54
56
 
55
57
  ## 环境变量
@@ -59,6 +61,7 @@ Youmai 的智能体配置导出只保存 MCP 资源 ID,不附带 npm/Python
59
61
  | `SHERLOCK_MCP_PYTHON` | 可选,Python 可执行文件路径;不接受 shell 命令或附加参数。默认按 PATH 检测 `python`、`python3` |
60
62
  | `SHERLOCK_MCP_CACHE_DIR` | 可选,独立 Python 依赖缓存根目录 |
61
63
  | `AGENTHUB_USER_DATA` | Youmai 可注入;未指定独立缓存时使用其 `sherlock-mcp/` 子目录 |
64
+ | `SHERLOCK_SEARXNG_URL` | 可选,自建 SearXNG 基址(启用 JSON 输出);未设置时使用公开 Bing RSS 搜索,无需 API 密钥。配置后只使用 SearXNG,不静默换源。所有请求沿用同一个授权代理,故该服务必须能从代理出口访问 |
62
65
  | `SHERLOCK_MCP_INDEX_URL` | 可选,安装 wheel 的 Python 包索引,默认 `https://pypi.org/simple`;仍强制校验锁定文件中的哈希 |
63
66
  | `HTTPS_PROXY`、`HTTP_PROXY`、`ALL_PROXY` | 可选,查询优先使用 HTTPS、HTTP、ALL 的第一个已设置值,小写同名变量优先。支持 HTTP(S)、SOCKS5、SOCKS5H;Youmai 的其他节点协议由平台转为 HTTP relay |
64
67
 
@@ -100,6 +103,30 @@ Youmai 的智能体配置导出只保存 MCP 资源 ID,不附带 npm/Python
100
103
 
101
104
  每条记录保留 `raw_status`。遇到 401、403、407、408、425、429、5xx 时,除已经识别出的 WAF,统一纠正为 `UNKNOWN`,避免上游把访问失败当成未命中。所有结果的 `identity_status` 固定为 `unverified`;本包不关联自然人身份,也不读取私密资料。相同主页的重复读取不算独立证据。
102
105
 
106
+ ### `social_profile_search`
107
+
108
+ 通过同一个 stdio MCP 查询 Facebook、Twitter/X、LinkedIn 的公开账号候选;与 `sherlock_search` 的站点规则检测分开记录。Facebook 和 LinkedIn 因登录页误报不在固定的 Sherlock 规则中,本工具使用公开网页搜索补充,不能把它们强传给 `sherlock_search.sites`。
109
+
110
+ ```json
111
+ {
112
+ "username": "example_user",
113
+ "platforms": ["facebook", "twitter", "linkedin"],
114
+ "limit_per_platform": 3,
115
+ "fetch_profiles": true,
116
+ "timeout_seconds": 10,
117
+ "total_timeout_seconds": 60
118
+ }
119
+ ```
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`,失败不直连。原始传输错误和凭据不进入结果。
129
+
103
130
  ## 版本与规则
104
131
 
105
132
  固定使用 Sherlock 0.16.2。平台规则来自该官方 wheel,误报排除名单来自官方 exclusions 分支;`resources/snapshot.json` 保存来源、采集日期和 SHA-256。构建会检查快照校验值;列表和搜索不在线更新规则。