wo9230/osint-agent

# OSINT Agent — 外贸防诈骗 · 客户背调 · B2B 商业情报系统 外贸人最怕的三件事：**客户是骗子、供应商是皮包公司、竞品在暗处降价**。每年有多少外贸人栽在"看起来很正规"的假客户、假订单、假工厂上？这个工具用公开数据（OSINT）把暗处照亮——签合同、发样品、走信用证之前，先花 15 分钟给对方做一次背调，拿到一份包含**公司背景、财务分析、供应链溯源、决策人画像、风险评级、脉络分析**的专业 HTML 报告，识别诈骗信号。 适用场景：**外贸防诈骗 / 客户背景调查 / 展会客户核实 / 买家资信调查 / 防止贸易诈骗 / 海外供应商尽职调查 / 皮包公司识别 / 跨境电商竞品分析 / 亚马逊卖家背景调查**。 ## 它能做什么 | 输入一条命令 | 得到什么 | |------------|---------| | `/osint Anker company` | 公司全维度调查报告（工商+财务+供应链+脉络） | | `/osint "张三" person` | 决策人个人画像（LinkedIn+社媒+职业轨迹） | | `/osint 某工厂 supplier` | 国内供应商风险评估 | | `/osint BrandX competitor` | 竞品情报（弱点矩阵+BCG+供应链） | | `/osint ASIN amazon-seller` | 亚马逊卖家背调 | | `/osint 行业名 industry` | 行业快扫（规模+格局+五力+PESTEL） | | `/osint 某公司 quick-id` | 2 分钟快速身份识别 | **共 15+ 种调查类型**，覆盖公司、个人、供应商、竞品、亚马逊卖家、行业、买家画像等场景。 ## 适合谁 - 外贸公司：客户背调、供应商验证、竞品分析 - 工厂：海外客户真实性验证、市场进入评估 - 跨境电商：亚马逊竞品调查、卖家身份识别 - SOHO/创业者：低成本获取专业级商业情报 ## 安装（10 分钟） ### 前提条件 | 工具 | 说明 | |------|------| | [Claude Code](https://claude.ai/code) | Anthropic 官方 CLI，需要订阅（$20/月起） | | Python 3.10+ | MCP 服务器运行需要 | | Node.js 18+ | 部分 MCP 工具需要 npx | | Git | 克隆仓库 | ### 第一步：克隆仓库 git clone https://github.com/wo9230/osint-agent osint-agent cd osint-agent ### 第二步：配置 API Key cp .env.example .env 用编辑器打开 `.env`，填入你的 API Key（获取方式见文件内注释）。 **最低配置**：只填 `HUNTER_API_KEY` 就能跑基本调查。 **推荐配置**：填满所有 Key，解锁全部能力。 ### 第三步：安装依赖 # 一键安装 bash setup/install.sh # 或手动安装 pip3 install requests httpx python-whois dnspython beautifulsoup4 certifi npm install -g npx ### 第四步：检查环境 python3 setup/check_env.py 看到全绿就说明安装成功。 ### 第五步：开始使用 cd osint-agent claude 在 Claude Code 里输入： /osint TestCompany company 等待 10-15 分钟，报告自动生成在 `reports/osint/` 目录。 ## 目录结构 osint-agent/ ├── CLAUDE.md ← 系统配置（核心） ├── .claude/ │ ├── commands/osint.md ← 命令入口 │ └── mcp.json ← MCP 配置 ├── skills/ ← 20+ 调查技能文件 ├── mcp_servers/ ← 8 个情报工具服务 ├── reports/osint/ ← 报告输出目录 │ └── report-template.css ← 报告样式模板 ├── docs/ ← 参考文档 ├── setup/ ← 安装工具 │ ├── install.sh │ └── check_env.py ├── .env.example ← API Key 模板 └── .env ← 你的 API Key（不要分享！） ## 包含的调查技能 | 技能 | 文件 | 用途 | |------|------|------| | 公司调查 | osint-company.md | 海外 B2B 公司全维度调查 | | 个人调查 | osint-person.md | 决策人画像 | | 供应商调查 | osint-supplier.md | 国内供应商风险评估 | | 竞品情报 | osint-competitor.md | 竞品弱点矩阵+BCG+供应链 | | 盈利分析 | osint-profitability.md | 产品盈利结构+财务健康度 | | 招聘情报 | osint-hiring.md | 人效对标+市场信号 | | DTC 拆解 | osint-dtc-china.md | 中国出海 DTC 品牌运营分析 | | 定价分析 | osint-pricing-anatomy.md | 定价瀑布+利润结构 | | 亚马逊卖家 | osint-amazon-seller.md | 卖家身份→公司→品牌→决策人 | | 快速识别 | osint-quick-id.md | 2 分钟商标→专利→域名→邮箱 | | 卖家发现 | osint-seller-scout.md | 品类→批量发现→快筛→联系方式 | | 销售手册 | osint-sales-playbook.md | 账号评分+触达序列 | | 行业快扫 | osint-industry.md | 规模+格局+五力+PESTEL | | 买家画像 | osint-persona.md | 行为聚类+Persona 卡片 | | 心理画像 | osint-psychograph.md | 深层恐惧→情感触发→价值观 | | 深度研究 | osint-research.md | 通用研究框架 | | 社媒脉搏 | osint-social-pulse.md | Reddit+YouTube 真实声音 | | 全球战略 | b2b-global-strategy/ | B2B 出海五步流程 | | 增长顾问 | strategic-growth-advisor/ | 麦肯锡级战略框架 | ## MCP 工具一览 | 工具 | 用途 | 需要 API Key | |------|------|:---:| | sales-intel | Hunter.io 邮箱查找+验证 | ✅ | | sec-edgar | 美股上市公司 SEC 财报 | ❌（免费） | | yfinance | 股票数据 | ❌（免费） | | social-analyzer | 1000+ 平台用户名扫描 | ❌（免费） | | maigret | 用户名跨平台搜索 | ❌（免费） | | spiderfoot | OSINT 综合扫描 | ❌（免费） | | web-check | 域名情报（技术栈+DNS+Whois） | ❌（免费） | | trade-intel | 海关数据+制裁名单 | ❌（免费） | | firecrawl | JS 页面深度抓取 | ✅ | | perplexity | AI 搜索增强 | ✅ | | playwright | 浏览器自动化 | ❌（免费） | | china-content | 中文内容平台采集 | ❌（免费） | | sellersprite | 亚马逊卖家数据 | ✅ | ## 常见问题 **Q: 需要什么技术基础？** A: 会用终端（命令行）即可。不需要写代码。 **Q: 每次调查花多少钱？** A: Claude API 费用约 $0.5-2/次调查，Hunter 免费版 25 次/月。 **Q: 报告可以直接发给客户吗？** A: 可以，HTML 格式，样式专业，可直接分享。 **Q: 数据安全吗？** A: 所有数据在你本地处理，不经过第三方服务器。API 调用直接从你的电脑发出。 **Q: 可以自定义报告模板吗？** A: 可以，修改 `reports/osint/report-template.css` 即可。 ## 合规与免责 本工具**只使用公开数据**，定位是商业尽职调查，不是人肉搜索： - ✅ 工商注册、SEC 财报、制裁名单、企业官网、公开评论——自由使用 - ⚠️ LinkedIn 公司页、WHOIS、业务邮箱——仅查公司信息，不批量爬个人数据 - ❌ 政治人物 / 军事情报 / 未成年人 / 私宅地址私人手机 / 暗网数据——硬性禁区，工具内置拦截 使用本工具即表示你已阅读并同意 [DISCLAIMER.md](DISCLAIMER.md)（完整免责声明：数据准确性、使用者责任、禁止用途、法律适用）。**报告仅供商业参考，重大决策请独立核实。** ## 技术支持 - 安装问题：参考 `setup/check_env.py` 的诊断输出 - 使用问题：先看 `QUICK-START.md` - 更多帮助：[提交 GitHub Issue](https://github.com/wo9230/osint-agent/issues)

标签：Claude Code, ESC4, MCP, MITM代理, OSINT, 商业情报, 外贸防诈骗, 客户背调, 特征检测, 自动化报告, 逆向工具