Gogu20/leadwire

# Leadwire

面向授权研究和数据质量工作流的感知提供商的工作邮箱发现与验证工具包。

_{Demo GIF 使用 Charmbracelet 的 VHS 录制。}

## 什么是 Leadwire Leadwire 接收潜在客户（lead）的姓名和公司信息（例如 `Jane Doe @ Acme`），并运行一个模块化流水线来查找可能的工作邮箱候选。它结合了域名发现、MX 情报、邮箱排列生成、感知提供商的验证、通过 user-scanner 进行的账户注册检查，以及在配置后通过 Reacher 进行的 SMTP 检查。 Leadwire 同时被构建为 CLI 和 Python 包。CLI 适用于本地运行和 CSV 批处理。Python API 通过类型化输入、类型化报告和显式配置公开了相同的流水线。 ## 安装 使用虚拟环境： ``` python3 -m venv .venv source .venv/bin/activate python3 -m pip install --upgrade pip python3 -m pip install -e . ``` 可选的集成需要单独安装： ``` python3 -m pip install -e ".[gemini]" python3 -m pip install -e ".[ghunt]" python3 -m pip install -e ".[all]" ``` Reacher 是一个可选的外部服务，用于 SMTP 验证和 catch-all 检测： ``` docker run -p 8080:8080 reacherhq/backend:latest ``` Leadwire 不捆绑或重新实现 Reacher 的 SMTP 引擎。 ## CLI 在运行发现工作之前检查环境： ``` leadwire modules list leadwire doctor ``` 运行单个客户： ``` leadwire single \ --first-name Jane \ --last-name Doe \ --company Acme ``` 处理 CSV： ``` leadwire csv --input leads.csv --output results.jsonl --format json ``` 使用 `--mode fast` 进行首次命中解析，使用 `--mode full` 进行带有候选排名的有界证据收集。 ## Python API ``` import asyncio from leadwire import Lead, Leadwire async def main() -> None: async with Leadwire(mode="fast") as client: report = await client.scan( Lead( first_name="Jane", last_name="Doe", company="Acme" ) ) print(report.best_email) asyncio.run(main()) ``` ## 文档 从 [docs/index.md](docs/index.md) 开始。 重要页面： - [首次本地运行](docs/tutorials/first-local-run.md) - [CLI 参考](docs/reference/cli.md) - [Python API 参考](docs/reference/python-api.md) - [配置参考](docs/reference/configuration.md) - [流水线与路由](docs/explanation/pipeline-and-routing.md) - [局限性](docs/explanation/limitations.md) - [架构](docs/explanation/architecture.md) - [安全与道德](docs/explanation/safety-and-ethics.md) ## 可接受的使用 Leadwire 旨在用于授权研究、内部数据质量工作和防御性评估。结果是经过排名的信号，而不是交付保证。在将结果投入实际运营使用之前，请阅读[局限性](docs/explanation/limitations.md)。 请参阅[可接受的使用](ACCEPTABLE_USE.md)。 ## 贡献 请参阅[贡献](CONTRIBUTING.md)。 ## 许可证 [MIT](LICENSE)

标签：Python, 文档结构分析, 无后门, 电子邮件侦察, 请求拦截, 逆向工具