integrations

Routes investigation tasks to external OSINT integrations based on preflight availability status.

43|8|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/buriedsignals/spotlight --skill integrations-buriedsignals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integrations
Source: https://github.com/buriedsignals/spotlight/tree/main/skills/integrations
Command: npx skills add https://github.com/buriedsignals/spotlight --skill integrations-buriedsignals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? During an OSINT investigation, agents must decide which external tool (browser automation, social-media collection, account discovery, academic access) fits each task, and avoid routing to integrations that are unconfigured or failing. ## Core Features & Use Cases - Routing decision tree: Maps investigation needs (deleted-post tracking, username discovery, corpus analysis, DOI lookup) to the right integration such as Junkipedia, Maigret, Apify, Arbiter, or Unpaywall. - Preflight-gated selection: Checks integrations/preflight.py output and only routes to integrations with green status, falling back to core verbs or local tool indexes otherwise. - Evidence-grounded output handling: Enforces saving raw responses to the case directory, citing access methods, and treating Maigret results as unverified leads only. - Use Case: An agent needs to track how a claim spread across platforms; it consults the routing table, confirms Junkipedia is green via preflight, reads its integration.md, and executes the documented API calls. ## Quick Start Ask the agent which external integration should handle tracking a deleted social post and have it check preflight status before routing.

Frequently Asked Questions about integrations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right OSINT integration for an investigation task?

Use the routing decision tree to match your task type to an integration: Junkipedia for deleted posts and narrative tracking, Maigret for username discovery, Apify for bounded social-post collection, and Unpaywall for academic DOI lookups. Always confirm the integration is green in preflight before routing.

How do I check if an integration is available before using it?

Run python3 integrations/preflight.py with the model tier and --json flag, then parse the output. Only route to integrations with green status; red or yellow statuses mean missing environment variables or failed smoke tests, so use a fallback instead.

Can Maigret results be used as attribution proof?

No, Maigret produces unverified account-discovery leads only and must never be used as attribution proof. Its output cannot be marked verified, confirmed, or publishable, and findings require independent corroboration through other sources.

What happens to integrations in sensitive mode?

When sensitive mode is true, any integration requiring remote API calls becomes unavailable. Pre-cached responses in the case research directory remain readable, and local-only browser runs against archived content may still work through dev-browser.

What is the fallback when the OSINT Navigator is unavailable?

The default fallback is running python3 scripts/osint-tools.py find with keywords against the local SQL index of 12,500 tools. This works offline without a subscription and is the standard path for local and open tiers.