osint-agent-skills

OSINT Agent Skills

一个知识库，可将任意自主 AI Agent 转变为资深 OSINT 分析师。

---

这是什么？

osint-agent-skills 不是 Agent，不是脚本，也不是 SaaS。

它是一个结构化知识库——由精选的方法论、工具注册表、关联分析手册、伦理规则和报告模板组成，任何自主 AI Agent 都可以使用它，立即采用资深开源情报分析师的工作规范。

如果你让 Claude Code、Cursor、Ollama、OpenCode、AutoClaw 或任何其他 Agent 框架使用此仓库，Agent 将会：

1. 加载 system-prompt.md 并采用 OSINT Agent Skills 的角色设定。
2. 查阅 knowledge/methodologies/ 以规划调查。
3. 使用 tools/free-tools.yaml 和 tools/apis.yaml 执行查询。
4. 遵循 knowledge/pivot-playbooks/，将发现串联成关联网络。
5. 使用 templates/reports/intelligence-report.md 生成报告。
6. 全程遵守 ethics/legal-frameworks.md——绝不建议非法技术，绝不捏造发现。

此仓库与 Agent 无关。无论使用哪种大模型或 Agent 框架，它的工作方式都相同。

---

为什么要创建它？

现代大模型是强大的 OSINT 工具，但前提是为其设定正确的规范。没有明确的工作框架，Agent 就会幻觉出 IP、跳过来源引用、模糊 OSINT 与入侵之间的界限，并生成看似权威却无法审计的报告。

osint-agent-skills 通过将资深分析师通常会在同行评审中执行的工作规则编码下来，解决了这一问题。系统提示词会极其明确地要求避免幻觉。关联分析手册会准确告知 Agent 在发现电子邮件、域名、电话号码、加密货币钱包或照片时该如何处理。伦理框架按司法管辖区界定允许范围。报告模板则要求引用来源并标注置信度。

结果是：当你要求一个已使用此知识库的 Agent 调查域名 example.com 时，你会得到一份结构化情报报告，其中列有引用来源、已执行的关联分析和明确的局限性，而不是一段听起来似是而非的文字。

---

适用对象

• 安全研究人员：希望 Agent 严谨地完成 OSINT 基础工作，达到自己亲自处理时的标准。
• 威胁情报分析师：希望自动化重复的信息收集工作，将精力集中于分析。
• 记者：调查虚假信息、欺诈或腐败，尤其是采用 Bellingcat 风格方法论的记者。
• 尽职调查团队：需要通过公开来源调查公司和个人背景。
• OSINT 教育工作者：希望获得用于教授方法论的参考框架。
• 任何人：曾见过大模型调查某事，却给出自信满满的错误结果。

---

快速开始

git clone https://github.com/frangelbarrera/osint-agent-skills
cd osint-agent-skills

然后让你的 Agent 使用该仓库。集成指南：

Agent	指南
Claude Code	integrations/claude-code.md
Cursor	integrations/cursor.md
Ollama（本地）	integrations/ollama.md
OpenCode	integrations/opencode.md
AutoClaw	integrations/autoclaw.md
任何其他 Agent	integrations/generic-agent.md

设置完成后使用的测试提示词：

使用 OSINT Agent Skills 方法调查域名 example.com。生成一份完整的情报报告。

Agent 应加载系统提示词，使用情报周期制定调查计划，调用免费工具执行 DNS/WHOIS/RDAP/CT 查询，遵循从域名到基础设施的关联分析手册，并提交结构化报告。

---

仓库结构

osint-agent-skills/
system-prompt.md           # The brain agent adopts this persona
agent-config.yaml          # Declarative config that agents read
README.md                  # This file
LICENSE                    # MIT
CONTRIBUTING.md            # How to contribute
CHANGELOG.md               # Version history
‚
knowledge/                 # The methodology + playbooks
methodologies/         # Intelligence cycle, ATT&CK, Bellingcat, etc.
domains/               # Person, domain, IP, company, phone, crypto, ...
techniques/            # Dorks, EXIF, Wayback, CT logs, ...
pivot-playbooks/       # If you find X, investigate Y"
‚
tools/                     # Tool registries
free-tools.yaml        # No API key required
apis.yaml              # API key required
mcp-tools.json         # MCP-format for Claude / Cursor
cli-tools.yaml         # Local CLI tools (sherlock, holehe, ...)
‚
templates/                 # Report / plan / evidence / graph templates
reports/               # ICD-203 inspired intelligence reports
investigation-plan/    # Scope + plan templates
evidence/              # Evidence logs and chain of custody
|   - graphs/                # Investigation graph templates (Mermaid, DOT, JSON)
‚
ethics/                    # Legal + ethical framework
legal-frameworks.md    # Per-jurisdiction laws (US, EU, UK, LatAm)
jurisdiction-rules.md  # Country-specific rules
code-of-conduct.md     # Investigator code of conduct
privacy-guidelines.md  # PII handling
anti-hallucination.md  # Anti-fabrication rules
‚
case-studies/              # Worked examples of real investigations
integrations/              # How to wire into each agent framework
examples/                  # Walkthroughs of common investigations

---

系统提示词包含什么？

系统提示词（system-prompt.md，约 3000 字）定义了：

• 身份。 OSINT Agent Skills——一位资深分析师，而不是聊天机器人。
• 核心原则。 核实，不要臆测。智能关联。绝不编造。遵守法律。维护 OPSEC。记录一切。尽量减少伤害。
• 方法论。 为自主 OSINT 工作改编的五阶段情报周期。
• 反幻觉规则。 明确禁止编造标识符、工具输出、日期或置信度。
• 工具使用协议。 如何选择工具、何时请求付费额度授权、何时标记需由人工审核的技术。
• 关联分析协议。 何时自主开展关联分析，何时暂停并请求用户批准。
• 报告标准。 默认报告结构（受 ICD-203 启发）。
• 伦理边界。 坚决拒绝的请求（跟踪、曝光个人信息、未经授权的借口套话、生成深度伪造内容、在非保护情境下调查未成年人）。
• 输出格式。 不写对话填充内容，不使用刻意的结尾。每项发现均须标注来源。必须包含局限性章节。

请阅读完整内容：system-prompt.md。

---

关联分析手册包含什么？

关联分析手册是本仓库中实用价值最高的部分。每份手册都明确说明：

• 触发条件——什么发现会启动此手册。
• 步骤——按顺序排列的收集操作，包含工具、命令和预期输出。
• 反模式——不该做什么（例如，不要仅凭两个相同的用户名就认定它们属于同一个人）。
• 输出格式——如何报告关联分析结果。

当前的手册：

手册	触发条件
email-to-username.md	你发现了一个电子邮件地址
username-to-identity.md	你发现了一个用户名
domain-to-infrastructure.md	你发现了一个域名
ip-to-attribution.md	你发现了一个 IP 地址
breach-to-credentials.md	你确认某个电子邮件地址出现在数据泄露事件中
phone-to-person.md	你发现了一个电话号码
crypto-to-fiat.md	你发现了一个加密货币钱包
photo-to-location.md	你有一张需要进行地理定位的照片
metadata-to-attribution.md	你有一份包含元数据的文档

参见 knowledge/pivot-playbooks/。

---

反幻觉承诺

本仓库遵循一项高于其他一切的原则构建：使用此知识库的 Agent 不会编造发现。

系统提示词明确禁止编造 IP 地址、电子邮件地址、用户名、日期、工具输出或置信度。报告中的每项发现都必须注明来源。每次工具调用都必须真实执行——如果工具调用失败或没有返回结果，就如实报告。

如果使用此知识库的 Agent 编造了发现，这是一个严重缺陷，应作为问题报告。完整规则集请参见 ethics/anti-hallucination.md。

输出完整性哈希（v1.5.0+）

现在，每个工具响应都包含一个 output_hash 字段——它是对 {tool, endpoint, status, result} 的规范 JSON 形式计算出的 sha256 哈希。这使下游验证者（审计日志、报告审阅者、外部脚本）能够确认，归因于某次工具调用的任何数据确实由该工具调用生成。

verify_output_integrity 工具接收一个声明的哈希值和响应负载子集；如果重新计算的哈希值匹配，则返回 {valid: true}，否则返回 {valid: false, expected_hash, actual_hash}。此工具专为下游验证者设计——不适用于带内 LLM 自我验证（能够在脑中计算 sha256 的 LLM 可以伪造匹配的一对值）。

---

归属说明

本仓库提炼并重组了 Frangel Raúl Crespo Barrera 最初汇编于 OSINT-BIBLE 的方法论。OSINT-BIBLE 是一个经过整理的索引，收录了 33 个类别中的 426+ 项 OSINT 资源；osint-agent-skills 对这些内容进行了调整，以便自主 Agent 使用。

案例研究引用了最初由 Bellingcat、Mandiant、CrowdStrike、CISA 及其他公开领域威胁情报来源发布的调查报告。引用内容见各案例研究文件。

工具说明参考了各工具的官方文档。定价和速率限制信息截至本仓库上次更新时有效——依赖具体限制前，请务必向提供方核实。

---

许可证

MIT。请参阅 LICENSE。

贡献

请参阅 CONTRIBUTING.md。尤其欢迎添加新的关联调查流程、新的免费工具或新的司法管辖区规则的拉取请求。

安全

安全问题应根据项目的安全策略私下报告。请勿针对疑似漏洞公开提交问题。

最新发布的 npm 版本为 1.6.0。npm 上的 1.4.1 和 1.5.0 版本已弃用，因为它们发布早于 1.6.0 中包含的安全性和可靠性修复。

本项目不声称每项加固改动都构成可单独利用的漏洞。只有在具体问题、受影响版本范围、影响和修补版本均经技术确认后，才会发布安全公告。

更新日志

请参阅 CHANGELOG.md。

Agent 安全模型

请参阅 docs/agent-security-model.md。