AI导哈

社交媒体用户名搜索工具

Sherlock MCP Server 是一个用于搜索社交媒体账户的开源情报工具，支持400多个平台，适用于OSINT研究人员、网络安全专业人员和AI助手进行用户名枚举和开源情报收集。

  • by Burnsedia
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 Burnsedia/sherlock-mcp

使用说明

Sherlock MCP服务器

Sherlock OSINT工具的FastMCP服务器集成 -使用模型上下文协议在400多个平台上无缝搜索社交媒体帐户。非常适合OSINT研究人员、网络安全专业人员和执行用户名枚举和开源情报收集的人工智能助理。

任务

该项目致力于通过道德开源情报寻找真相和打击宣传。在一个错误信息和数字操纵的时代，我们相信应该为调查人员、记者和真相寻求者提供透明、可验证的社交媒体侦察工具。

我们的使命是：

  • 促进真实调查：为事实核查和来源核查提供可靠的工具
  • 反宣传：实现对在线叙述和账户真实性的系统分析
  • 保持道德标准：确保所有使用都符合隐私权和负责任的披露
  • 促进透明度：用于社区审查和改进的开源开发

阅读我们的全文 使命宣言 详细的原理和应用。

特性

  • 用户名搜索：查找与用户名关联的社交媒体资料
  • 结构化输出：返回带有站点名称、URL和存在状态的格式化结果
  • 错误处理：优雅地处理缺失的依赖关系、超时和失败
  • 道德使用：专为负责的OSINT调查而设计
  • MCP集成：AI工作流中对模型上下文协议的原生支持

演示

使用此MCP服务器体验OSINT用户名搜索的强大功能。连接到您最喜欢的MCP兼容AI助手，立即查询社交媒体状态。

演示GIF或截图的占位符即将推出！

先决条件

  • Python 3.13+
  • 已安装Sherlock CLI工具： pipx install sherlock-project

Docker设置

对于使用官方Sherlock Docker镜像的容器化部署：

  1. 构建Docker镜像：

    docker build -t sherlock-mcp .

  2. 运行容器：

    docker run -it sherlock-mcp

这将启动容器内的MCP服务器。通过stdio管道连接MCP客户端或配置HTTP传输以进行远程访问。

安装

  1. 克隆此存储库：

    git clone <repo-url>
cd sherlock-mcp

  2. 安装依赖项：

    pip install -e .

  3. 确保已安装Sherlock：

    pipx install sherlock-project

用法

运行服务器

python main.py

这将使用stdio传输启动MCP服务器，为MCP客户端做好准备。

MCP客户端使用示例

当连接到MCP兼容客户端（例如Claude Desktop）时，请使用 search_username 工具：

Tool: search_username
Arguments: {"username": "exampleuser"}

答复：

{
  "found": [
    {"site": "github", "url": "https://github.com/exampleuser", "exists": true},
    {"site": "twitter", "url": "https://twitter.com/exampleuser", "exists": true}
  ],
  "total_found": 2,
  "error": null
}

工具参考

search_username(username: str)

搜索与给定用户名关联的社交媒体帐户。

参数：

  • username （str）：要搜索的用户名

退货：

  • found （列表）：已找到的配置文件数组，包括站点、URL和存在状态
  • total_found （int）：找到的配置文件数量
  • error （str）：错误消息（如果有）（成功时为null）

贡献

我们欢迎为增强此OSINT MCP服务器做出贡献！无论是bug修复、新功能还是文档改进，您的投入都有助于网络安全和人工智能社区。

  1. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

请阅读我们的 贡献指南 了解更多详情。

伦理考量

这个工具是为寻求真相和对抗宣传而设计的，但强大的力量带来了巨大的责任。始终以合乎道德和合法的方式使用。

一般准则

  • 仅用于合法的OSINT目的
  • 尊重平台服务条款
  • 注意隐私问题
  • 考虑限速以避免服务不堪重负

反宣传最佳实践

  • 交叉引用来源：跨多个平台验证帐户真实性
  • 检查创建日期：新帐户可能表示协调的活动
  • 分析模式：寻找协调的发布行为或类似内容
  • 尊重隐私：关注公共信息，避免多面手
  • 事实核查结果：对索赔使用其他验证工具
  • 文件编制方法：保持调查过程的透明度
  • 避免伤害：不要利用调查结果骚扰或恐吓个人

负责任的使用

  • 获得适当的调查授权
  • 遵守当地法律法规
  • 利用调查结果促进真相和问责制
  • 负责任地分享结果，避免造成错误信息

故障排除

  • 找不到夏洛克：安装 pipx install sherlock-project
  • 超时错误：增加代码中的超时时间或使用较小的用户名集
  • 无结果：用户名在搜索的平台上可能不存在

许可证

MIT许可证

相关 MCP