vixkram/OSINTBox-data
GitHub: vixkram/OSINTBox-data
一个以 JSON 格式存储和管理 OSINT 工具分类数据的社区驱动型仓库，通过 Schema 校验保障数据质量并支持便捷的社区贡献。
Stars: 72 | Forks: 9
# 🔍 OSINTBox 数据
[](https://github.com/vixkram/OSINTBox-data/actions)
[](#-contribute)
[](LICENSE)
## 📁 仓库结构
```
├── 📄 tools.json # Core categories and tools
├── ⚙️ widgets.json # Widget configuration
└── 📋 schema/ # JSON schemas for validation
├── tools.schema.json
└── widgets.schema.json
```
### 🔧 文件说明
| 文件 | 状态 | 说明 |
|------|--------|-------------|
| `tools.json` | **必需** | 按类别组织的 OSINT 工具主数据库 |
| `widgets.json` | *可选* | 仪表盘小部件的配置（世界时钟、订阅源等） |
### 📝 快速开始
1. **Fork** 本仓库
2. **编辑** `tools.json`（如有需要，可一并编辑 `widgets.json`）
3. **发起** Pull Request
4. **等待** 自动化验证通过
### ✅ 本地验证（可选）
想在提交前测试更改？请按照以下步骤操作：
```
# 安装 validation tools
npm i -D ajv-cli@5
# 验证你的更改
npx ajv validate -s schema/tools.schema.json -d tools.json --all-errors
# 验证 widgets（如果已修改）
if [ -f widgets.json ]; then
npx ajv validate -s schema/widgets.schema.json -d widgets.json --all-errors
fi
```
## 📊 数据 Schema
### 🛠️ 工具对象
```
{
"name": "Tool Name",
"url": "https://example.com"
// Optional overrides:
// "description": "Brief description",
// "icon": "https://example.com/favicon.ico"
}
```
### 📂 类别对象
```
{
"category": "Category Name",
"tools": [
// Array of tool objects
]
}
```
## 💡 最佳实践
### ✏️ 编写指南
- **描述**：仅当其能提供超越工具名称本身的明确价值时才添加（否则省略）
- **图标**：通常省略 —— UI 会根据工具域名自动生成 favicon。仅在需要覆盖时才设置 `icon`。
- 不要使用第三方代理；如有需要，请使用直接的图片 URL（例如，网站真实的 favicon）。
- **URL**：确保所有链接有效并指向规范页面；移除跟踪参数
### 🎯 质量标准
- ✅ 添加前验证工具功能
- ✅ 使用清晰、具有描述性的名称
- ✅ 进行适当的分类
- ✅ 测试所有 URL
## 🚀 开始使用
1. **浏览** `tools.json` 文件以查看现有类别和工具
2. **寻找** 缺失内容或待添加的新工具
3. **遵循** Schema 结构
4. 通过 Pull Request **提交**您的贡献
## 📞 支持
- 🐛 **问题**：报告 Bug 或提出改进建议
- 💬 **讨论**：发起一个 Issue 来描述您建议的更改
标签：Homebrew安装, 安全数据, 实时处理, 工具集, 暗色界面, 网络连接监控