mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-08-01 08:30:20 +00:00
24f816b6a3
Place useful parts of the surrounding repos into sica-fondt by layer, per the
body model (Ada = membrane; brain/endocrine/capabilities/knowledge non-Ada):
- brain/ LLM reasoning + providers (dapr, hermes, MoMoA)
- capabilities/ REPRAG sidecars: hermes tools/skills, dapr tools, parallel
dispatch, A51 channels, and the OSINT cluster
- knowledge/ LORAG corpus: 754 cyber-skills, agency personas, secure-coding,
MITRE ATT&CK data
- reference/ defensive threat-reference (C3, shhbruh doc) + AdaYaml parser
License handling: AGPL sources (worldosint, advanced_evolution, mercury,
Reticulum) and GPL DeTTECT are SPEC-only clean-room/port descriptions — no
copyleft code copied. MIT/Apache/data parts copied as working trees.
Safety: shhbruh escape/persistence material and C3 covert-C2 kept as reference
only, not wired into the running organism. See CONSOLIDATION.md.
https://claude.ai/code/session_01UehUqEXXJJCsHoA4voCU5c
63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
# API Reference: Monitoring Dark Web Sources
|
|
|
|
## Have I Been Pwned API v3
|
|
|
|
| Endpoint | Method | Description |
|
|
|----------|--------|-------------|
|
|
| `/api/v3/breaches` | GET | List all known data breaches |
|
|
| `/api/v3/breach/{name}` | GET | Get details of a specific breach |
|
|
| `/api/v3/pasteaccount/{email}` | GET | Search paste site archives for an email |
|
|
| `/api/v3/breachedaccount/{email}` | GET | Check if email appears in breaches |
|
|
|
|
## Dehashed API
|
|
|
|
| Endpoint | Method | Description |
|
|
|----------|--------|-------------|
|
|
| `/search?query=domain:example.com` | GET | Search exposed credentials by domain |
|
|
| `/search?query=email:user@example.com` | GET | Search by specific email address |
|
|
|
|
## Ransomware.live API
|
|
|
|
| Endpoint | Method | Description |
|
|
|----------|--------|-------------|
|
|
| `/recentvictims` | GET | List recent ransomware leak site victims |
|
|
| `/groups` | GET | List tracked ransomware groups |
|
|
| `/group/{name}` | GET | Get details for a specific ransomware group |
|
|
|
|
## Recorded Future Dark Web Module
|
|
|
|
| Endpoint | Method | Description |
|
|
|----------|--------|-------------|
|
|
| `/v2/darkweb/search` | GET | Search dark web mentions by keyword |
|
|
| `/v2/credentials/search` | GET | Search exposed credentials |
|
|
|
|
## Key Libraries
|
|
|
|
- **requests**: HTTP client for HIBP, Dehashed, and ransomware.live APIs
|
|
- **spiderfoot** (CLI): OSINT automation including dark web module `sfp_darkweb`
|
|
- **theHarvester**: Domain reconnaissance including breach data sources
|
|
|
|
## Configuration
|
|
|
|
| Variable | Description |
|
|
|----------|-------------|
|
|
| `HIBP_API_KEY` | Have I Been Pwned API key (paid tier for domain search) |
|
|
| `DEHASHED_API_KEY` | Dehashed API key for credential exposure search |
|
|
| `DEHASHED_EMAIL` | Dehashed account email for API authentication |
|
|
| `RF_API_TOKEN` | Recorded Future API token for dark web module |
|
|
|
|
## Rate Limits
|
|
|
|
| API | Rate Limit |
|
|
|-----|------------|
|
|
| HIBP | 10 requests/minute (paid key) |
|
|
| Dehashed | 5 requests/second |
|
|
| Ransomware.live | No published limit (be respectful) |
|
|
|
|
## References
|
|
|
|
- [Have I Been Pwned API](https://haveibeenpwned.com/API/v3)
|
|
- [Dehashed API Docs](https://www.dehashed.com/docs)
|
|
- [Ransomware.live](https://www.ransomware.live/)
|
|
- [SpiderFoot OSINT](https://github.com/smicallef/spiderfoot)
|