| name | osint-api |
| description | AI-powered OSINT intelligence reports via API. 129 RSS feeds across 15 categories with enriched analysis, domain recon, and automated feed health monitoring.
|
| homepage | https://github.com/ahsan-tariq-ai/osint-api |
| metadata | {"clawdbot":{"emoji":"🔍","requires":{"env":"[Truncated]"},"primaryEnv":"OSINT_API_KEY","files":["scripts/osint_api.py"],"externalEndpoints":["https://osint.ahsan-tariq-ai.xyz/api/v1"],"trust":"This skill calls a single hosted API at osint.ahsan-tariq-ai.xyz. The helper script (scripts/osint_api.py) makes HTTPS requests to that domain only — no other network access, no local files read/written, no shell commands executed. The OSINT_API_KEY environment variable is required for authenticated endpoints.\n"}} |
OSINT API — Intelligence Reports
AI-powered OSINT intelligence reports via API. 129 RSS feeds across 15 categories with enriched analysis, domain recon, and automated feed health monitoring.
External Endpoints
All requests go to a single hosted API:
| Endpoint | Method | Purpose | Auth Required |
|---|
https://osint.ahsan-tariq-ai.xyz/api/v1/reports/enriched | GET | Intelligence briefings | Yes |
https://osint.ahsan-tariq-ai.xyz/api/v1/reports/categories | GET | List categories | Yes |
https://osint.ahsan-tariq-ai.xyz/api/v1/recon/{domain} | GET | Domain recon (DNS/WHOIS/IP) | Yes |
https://osint.ahsan-tariq-ai.xyz/api/v1/social/{username} | GET | Social media profiles | Yes |
https://osint.ahsan-tariq-ai.xyz/api/v1/breach/{email} | GET | Breach database check | Yes |
Security & Privacy
- API key required — all endpoints require
OSINT_API_KEY environment variable
- Single external host — all requests go to
osint.ahsan-tariq-ai.xyz only
- No local file access — the helper script reads no local files
- No data persistence — responses are returned and not saved locally
- HTTPS only — all traffic encrypted via TLS
- Helper script —
scripts/osint_api.py is a thin Python wrapper that calls the API. It uses urllib.request (stdlib only), makes no shell calls, and performs no local I/O.
Required Environment
export OSINT_API_KEY="your_api_key_here"
Sign up for an API key at https://osint.ahsan-tariq-ai.xyz
Tools
get_reports
Get enriched intelligence briefings across 15 categories.
Endpoint: GET /reports/enriched
Parameters:
| Param | Type | Required | Default | Description |
|---|
| category | string | No | all | Filter by category name |
Usage:
python3 scripts/osint_api.py reports
python3 scripts/osint_api.py reports --category geopolitics
Or via curl (with API key):
curl -H "Authorization: Bearer $OSINT_API_KEY" \
"https://osint.ahsan-tariq-ai.xyz/api/v1/reports/enriched"
Response:
{
"status": "success",
"date": "2026-04-06",
"reports": [
{
"category": "geopolitics",
"enriched": true,
"confidence": 0.82,
"article_count": 47,
"briefing": "Escalating tensions in Eastern Europe..."
}
],
"total_categories": 15
}
get_categories
List all available report categories with metadata.
Endpoint: GET /reports/categories
Usage:
python3 scripts/osint_api.py categories
domain_recon
Get DNS, WHOIS, and IP intelligence for any domain.
Endpoint: GET /recon/{domain}
Parameters:
| Param | Type | Required | Description |
|---|
| domain | string | Yes | Domain to investigate |
Usage:
python3 scripts/osint_api.py recon --domain google.com
social_lookup
Find social media profiles for a username.
Endpoint: GET /social/{username}
Usage:
python3 scripts/osint_api.py social --username username
breach_check
Check if an email appears in known breach databases.
Endpoint: GET /breach/{email}
Usage:
python3 scripts/osint_api.py breach --email user@example.com
Categories
The engine collects from 129 RSS feeds across 15 categories:
| Category | Sources | Focus |
|---|
| cybersecurity | 25 feeds | Threats, CVEs, vendor advisories |
| tech_ai | 30 feeds | AI/ML news, product launches, research |
| geopolitics | 20 feeds | World news, conflict, diplomacy |
| finance | 12 feeds | Markets, crypto, economics |
| healthcare | 10 feeds | Pharma, biotech, medical research |
| legal_regtech | 5 feeds | Law, compliance, regulatory focus |
| marketing_adtech | 7 feeds | Marketing industry, ad tech |
| supply_chain | 5 feeds | Logistics, freight, supply chain |
| climate_sustainability | 7 feeds | Climate change, ESG, green tech |
| real_estate_proptech | 5 feeds | Property, PropTech |
| education_edtech | 5 feeds | Education technology |
| energy_utilities | 5 feeds | Power, energy, utilities |
| agriculture_foodtech | 5 feeds | Agriculture, food tech |
| entertainment_media | 8 feeds | Gaming, streaming, media |
| labor_workforce | 4 feeds | Labor market, workplace intelligence |
Helper Script
scripts/osint_api.py is a thin Python wrapper (stdlib only, no dependencies) that calls the OSINT API. It:
- Makes HTTPS requests to
osint.ahsan-tariq-ai.xyz only
- Requires
OSINT_API_KEY environment variable
- Reads no local files, writes no local files
- Executes no shell commands
- Sanitizes all input via
urllib.parse.quote
Pricing
| Tier | Price | Requests/Day | Features |
|---|
| Free | $0 | 10 | Basic recon |
| Developer | $5/mo | 1,000 | Social + email lookup |
| Pro | $49/mo | Unlimited | All skills + PDF reports |
| Enterprise | Custom | Custom | SLA, dedicated instance |
Notes
- Reports are refreshed daily via cron — API responses are cached
- Geo-political categories receive hidden signal enrichment from geodetic astrology
- Output contains NO astrology language — reads as standard intelligence analysis
- Confidence scores: 0.0-1.0 based on article count, source diversity, signal strength
