osint-api

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 [e-mail]

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