lookup-crowdstrike
Queries the CrowdStrike Falcon Intelligence (Intel) API for indicator (IOC) reputation, threat-actor (adversary) profiles, actor search by origin/target, MITRE ATT&CK technique coverage, and finished intelligence reports. Retrieval only — do not interpret, assess, or conclude. The invoking skill or agent reasons about the result.
When to invoke
- User asks to look up an IP / domain / hash / URL and CrowdStrike credentials are configured — return CrowdStrike's malicious-confidence, linked actors, malware families, and report references alongside the other lookups
- User asks for the latest / recent malicious IOCs, a CrowdStrike indicator feed, or "what's CrowdStrike seeing lately" →
indicators --malicious (browse/sweep, newest-first; filter by type/actor/malware/recency)
- User asks "what TTPs / techniques does use?" →
ttps <actor> (MITRE ATT&CK mapping)
- User asks "which threat actors operate from ?" / "who targets ?" →
actors --origin <c> / --target-industry <i>
- User asks to profile a named adversary (Charming Kitten, Mustang Panda, Cozy Bear, …) →
actor <name>
- User wants the latest finished reporting on an actor or topic →
reports --actor <name> --latest or reports --search "<topic>"
/threat-actor-profiling or a regional espionage cell wants vendor-authoritative attribution, origins, motivations, and capability
- Need to download a specific intel report PDF by ID →
reports --pdf <id>
How to invoke
One CLI: a Python wrapper around the official crowdstrike-falconpy SDK. Self-bootstraps a private venv at tools/clis/.venv-crowdstrike/ on first run; no global install. The SDK exchanges your client id + secret for an OAuth2 bearer token at /oauth2/token automatically.
# IOC reputation — ip / domain / hash / url (auto-detected by CrowdStrike via FQL indicator: match)
python3 tools/clis/crowdstrike.py indicator <value> [--limit N] [--include-deleted]
# Browse / sweep the indicator feed — latest malicious IOCs, by type / actor / recency
python3 tools/clis/crowdstrike.py indicators [--malicious] [--type ip|domain|url|hash|md5|sha1|sha256|email] \
[--actor "<name>"] [--malware <family>] [--since 7d] [--filter "<FQL>"] [--limit N]
# Profile a single named threat actor (adversary)
python3 tools/clis/crowdstrike.py actor "<name>" [--limit N] [--fields F1,F2,...]
# Search actors by origin / target / motivation / raw FQL
python3 tools/clis/crowdstrike.py actors [--origin russia] [--target-country united-states] \
[--target-industry financial-services] [--motivation state-sponsored] [--filter "<FQL>"] [--limit N]
# Finished intel reports — by actor, free-text, latest-first, or PDF download
python3 tools/clis/crowdstrike.py reports [--actor "<name>"] [--search "<q>"] [--filter "<FQL>"] \
[--latest] [--limit N] [--pdf <report_id> --out <path>]
# MITRE ATT&CK techniques mapped to an actor (add --detailed for the full Navigator/CSV/JSON report)
python3 tools/clis/crowdstrike.py ttps "<actor>" [--detailed] [--format csv|json|json_navigator]
All subcommands accept --dry-run to preview the request plan without spending an API call, and --base-url to override the cloud region for one call. All exit code 2 if $CROWDSTRIKE_CLIENT_ID or $CROWDSTRIKE_CLIENT_SECRET is unset (when not in dry-run). Report missing credentials; do not fabricate.
Examples
# 0) "What are the latest 10 malicious IOCs from CrowdStrike?"
python3 tools/clis/crowdstrike.py indicators --malicious --limit 10
# e.g. latest malicious domains from the past week tied to an actor:
python3 tools/clis/crowdstrike.py indicators --malicious --type domain --since 7d --actor "Fancy Bear"
# 1) "Look up IP 1.1.1.1" — CrowdStrike's view of the indicator
python3 tools/clis/crowdstrike.py indicator 1.1.1.1
# 2) "What TTPs does Charming Kitten use?"
python3 tools/clis/crowdstrike.py ttps "Charming Kitten" --detailed --format json_navigator
# 3) "Which threat actors operate from Russia?"
python3 tools/clis/crowdstrike.py actors --origin russia --limit 30
# 4) "Give me the latest report on Mustang Panda"
python3 tools/clis/crowdstrike.py reports --actor "Mustang Panda" --latest --limit 5
# 5) Profile an actor, then pull its newest report PDF
python3 tools/clis/crowdstrike.py actor "Cozy Bear"
python3 tools/clis/crowdstrike.py reports --pdf CSA-250123 --out cozy-bear-latest.pdf
Quota awareness
The Intel API is governed by CrowdStrike's per-tenant rate limit (token-bucket; the response carries X-RateLimit-Limit / X-RateLimit-Remaining headers). On exhaustion the API returns HTTP 429 with a Retry-After header — back off and retry. Each subcommand is a single API call, except ttps (resolves the actor slug, then queries MITRE — 2 calls, 3 with --detailed) and reports --pdf (1 call returning binary). Use --dry-run to confirm the call plan before fan-out across many actors.
Response format
The CLI emits JSON to stdout. Skills consuming it should treat it as:
source: crowdstrike
operation: indicator_lookup | indicator_search | actor_profile | actor_search | report_search | report_pdf | actor_ttps
indicator: <queried value or FQL>
type: indicator | indicator_query | actor | actor_query | report_query | report_id
base_url: https://api.crowdstrike.com
query_time: <ISO8601>
count: <n> # number of resources returned
# operation-specific payload — the SDK's deserialised resources array
indicators: [ ... ] # for `indicator`
actors: [ ... ] # for `actor`, `actors`
reports: [ ... ] # for `reports`
technique_ids: [ ... ] # for `ttps`; + mitre_report when --detailed
saved_to: <path> # for `reports --pdf`
Common fields inside each resource type:
| Resource |
Key fields |
| indicator |
indicator, type, malicious_confidence (high/medium/low/unverified), actors, malware_families, kill_chains, threat_types, reports, labels, published_date, last_updated |
| actor |
name, slug, short_description, description, known_as, origins[], target_countries[], target_industries[], motivations[], capability, group, actor_type, first_activity_date, last_activity_date |
| report |
name, title, slug, short_description, created_date, last_modified_date, actors[], target_countries[], target_industries[], tags[], report_type, url, attachments[] |
| ttps |
technique_ids[] (ATT&CK technique IDs); mitre_report (CSV / JSON / Navigator layer when --detailed) |
Rate limits
Per-tenant token bucket; 429 + Retry-After on exhaustion. indicator/actor/actors/reports = 1 call each; ttps = 2–3 calls. Back off on 429.
Source reliability (Admiralty default)
Default rating for downstream /score-source: A2 (completely reliable, probably true). CrowdStrike Falcon Intelligence is vendor-authoritative finished intelligence produced by a dedicated analyst team; attribution, origins, and TTP mappings are well validated.
Downgrade to B3 if:
- An indicator's
malicious_confidence is low or unverified
- An actor record is sparse (no
origins / capability) or flagged provisional
- The judgement rests on a single report with hedged language — read the report body, don't infer from the tag alone
Stay at A2 / consider A1 if:
malicious_confidence is high AND the indicator is linked to a named actor or malware family
- Multiple finished reports corroborate the actor attribution and TTP set
Related skills
/lookup-virustotal — community-aggregated detection; complements CrowdStrike's vendor view on the same IOC
/lookup-reversinglabs — vendor-authoritative malware classification + sandbox for a hash
/lookup-otx — community pulse context for the same indicator
/threat-actor-profiling — chains actor / ttps / reports into a full adversary profile
/ip-investigation, /domain-investigation, /hash-investigation, /url-investigation — chain the indicator lookup
/mitre-attack — resolve the technique_ids from ttps against the local ATT&CK dataset
/score-source — apply the Admiralty rating to the result
See also
1---2name: lookup-crowdstrike3description: "Use for CrowdStrike Falcon Intelligence on an indicator (IP, domain, hash or URL: malicious confidence, linked actors, malware families, reports) or an adversary (profile, origin/target search, ATT&CK TTPs, finished intel reports): \"look up 1.1.1.1\", \"what TTPs does Charming Kitten use?\", \"latest report on Mustang Panda\". Invoked by the /*-investigation skills, /ioc-enrichment-workflow, /threat-actor-profiling and the regional espionage cells. Requires a Falcon Intelligence subscription."4metadata:5 source: https://skillmd.com/skills/liberty91ltd/lookup-crowdstrike6 version: 1.0.07 tags: [lookup, threat-intel, actor-intel, finished-intel]8 api: crowdstrike9 default_source_reliability: A10 default_information_credibility: 211---1213# lookup-crowdstrike1415Queries the CrowdStrike Falcon Intelligence (Intel) API for indicator (IOC) reputation, threat-actor (adversary) profiles, actor search by origin/target, MITRE ATT&CK technique coverage, and finished intelligence reports. Retrieval only — do not interpret, assess, or conclude. The invoking skill or agent reasons about the result.1617## When to invoke1819- User asks to look up an IP / domain / hash / URL and CrowdStrike credentials are configured — return CrowdStrike's malicious-confidence, linked actors, malware families, and report references alongside the other lookups20- User asks for the latest / recent malicious IOCs, a CrowdStrike indicator feed, or "what's CrowdStrike seeing lately" → `indicators --malicious` (browse/sweep, newest-first; filter by type/actor/malware/recency)21- User asks "what TTPs / techniques does <actor> use?" → `ttps <actor>` (MITRE ATT&CK mapping)22- User asks "which threat actors operate from <country>?" / "who targets <sector>?" → `actors --origin <c>` / `--target-industry <i>`23- User asks to profile a named adversary (Charming Kitten, Mustang Panda, Cozy Bear, …) → `actor <name>`24- User wants the latest finished reporting on an actor or topic → `reports --actor <name> --latest` or `reports --search "<topic>"`25- `/threat-actor-profiling` or a regional espionage cell wants vendor-authoritative attribution, origins, motivations, and capability26- Need to download a specific intel report PDF by ID → `reports --pdf <id>`2728## How to invoke2930One CLI: a Python wrapper around the official `crowdstrike-falconpy` SDK. Self-bootstraps a private venv at `tools/clis/.venv-crowdstrike/` on first run; no global install. The SDK exchanges your client id + secret for an OAuth2 bearer token at `/oauth2/token` automatically.3132```bash33# IOC reputation — ip / domain / hash / url (auto-detected by CrowdStrike via FQL indicator: match)34python3 tools/clis/crowdstrike.py indicator <value> [--limit N] [--include-deleted]3536# Browse / sweep the indicator feed — latest malicious IOCs, by type / actor / recency37python3 tools/clis/crowdstrike.py indicators [--malicious] [--type ip|domain|url|hash|md5|sha1|sha256|email] \38 [--actor "<name>"] [--malware <family>] [--since 7d] [--filter "<FQL>"] [--limit N]3940# Profile a single named threat actor (adversary)41python3 tools/clis/crowdstrike.py actor "<name>" [--limit N] [--fields F1,F2,...]4243# Search actors by origin / target / motivation / raw FQL44python3 tools/clis/crowdstrike.py actors [--origin russia] [--target-country united-states] \45 [--target-industry financial-services] [--motivation state-sponsored] [--filter "<FQL>"] [--limit N]4647# Finished intel reports — by actor, free-text, latest-first, or PDF download48python3 tools/clis/crowdstrike.py reports [--actor "<name>"] [--search "<q>"] [--filter "<FQL>"] \49 [--latest] [--limit N] [--pdf <report_id> --out <path>]5051# MITRE ATT&CK techniques mapped to an actor (add --detailed for the full Navigator/CSV/JSON report)52python3 tools/clis/crowdstrike.py ttps "<actor>" [--detailed] [--format csv|json|json_navigator]53```5455All subcommands accept `--dry-run` to preview the request plan without spending an API call, and `--base-url` to override the cloud region for one call. All exit code 2 if `$CROWDSTRIKE_CLIENT_ID` or `$CROWDSTRIKE_CLIENT_SECRET` is unset (when not in dry-run). Report missing credentials; do not fabricate.5657### Examples5859```bash60# 0) "What are the latest 10 malicious IOCs from CrowdStrike?"61python3 tools/clis/crowdstrike.py indicators --malicious --limit 1062# e.g. latest malicious domains from the past week tied to an actor:63python3 tools/clis/crowdstrike.py indicators --malicious --type domain --since 7d --actor "Fancy Bear"6465# 1) "Look up IP 1.1.1.1" — CrowdStrike's view of the indicator66python3 tools/clis/crowdstrike.py indicator 1.1.1.16768# 2) "What TTPs does Charming Kitten use?"69python3 tools/clis/crowdstrike.py ttps "Charming Kitten" --detailed --format json_navigator7071# 3) "Which threat actors operate from Russia?"72python3 tools/clis/crowdstrike.py actors --origin russia --limit 307374# 4) "Give me the latest report on Mustang Panda"75python3 tools/clis/crowdstrike.py reports --actor "Mustang Panda" --latest --limit 57677# 5) Profile an actor, then pull its newest report PDF78python3 tools/clis/crowdstrike.py actor "Cozy Bear"79python3 tools/clis/crowdstrike.py reports --pdf CSA-250123 --out cozy-bear-latest.pdf80```8182### Quota awareness8384The Intel API is governed by CrowdStrike's per-tenant rate limit (token-bucket; the response carries `X-RateLimit-Limit` / `X-RateLimit-Remaining` headers). On exhaustion the API returns **HTTP 429** with a `Retry-After` header — back off and retry. Each subcommand is a single API call, except `ttps` (resolves the actor slug, then queries MITRE — 2 calls, 3 with `--detailed`) and `reports --pdf` (1 call returning binary). Use `--dry-run` to confirm the call plan before fan-out across many actors.8586## Response format8788The CLI emits JSON to stdout. Skills consuming it should treat it as:8990```yaml91source: crowdstrike92operation: indicator_lookup | indicator_search | actor_profile | actor_search | report_search | report_pdf | actor_ttps93indicator: <queried value or FQL>94type: indicator | indicator_query | actor | actor_query | report_query | report_id95base_url: https://api.crowdstrike.com96query_time: <ISO8601>97count: <n> # number of resources returned98# operation-specific payload — the SDK's deserialised resources array99indicators: [ ... ] # for `indicator`100actors: [ ... ] # for `actor`, `actors`101reports: [ ... ] # for `reports`102technique_ids: [ ... ] # for `ttps`; + mitre_report when --detailed103saved_to: <path> # for `reports --pdf`104```105106Common fields inside each resource type:107108| Resource | Key fields |109|---|---|110| indicator | `indicator`, `type`, `malicious_confidence` (high/medium/low/unverified), `actors`, `malware_families`, `kill_chains`, `threat_types`, `reports`, `labels`, `published_date`, `last_updated` |111| actor | `name`, `slug`, `short_description`, `description`, `known_as`, `origins[]`, `target_countries[]`, `target_industries[]`, `motivations[]`, `capability`, `group`, `actor_type`, `first_activity_date`, `last_activity_date` |112| report | `name`, `title`, `slug`, `short_description`, `created_date`, `last_modified_date`, `actors[]`, `target_countries[]`, `target_industries[]`, `tags[]`, `report_type`, `url`, `attachments[]` |113| ttps | `technique_ids[]` (ATT&CK technique IDs); `mitre_report` (CSV / JSON / Navigator layer when `--detailed`) |114115## Rate limits116117Per-tenant token bucket; `429` + `Retry-After` on exhaustion. `indicator`/`actor`/`actors`/`reports` = 1 call each; `ttps` = 2–3 calls. Back off on 429.118119## Source reliability (Admiralty default)120121Default rating for downstream `/score-source`: **A2** (completely reliable, probably true). CrowdStrike Falcon Intelligence is vendor-authoritative finished intelligence produced by a dedicated analyst team; attribution, origins, and TTP mappings are well validated.122123**Downgrade to B3** if:124- An indicator's `malicious_confidence` is `low` or `unverified`125- An actor record is sparse (no `origins` / `capability`) or flagged provisional126- The judgement rests on a single report with hedged language — read the report body, don't infer from the tag alone127128**Stay at A2 / consider A1** if:129- `malicious_confidence` is `high` AND the indicator is linked to a named actor or malware family130- Multiple finished reports corroborate the actor attribution and TTP set131132## Related skills133134- `/lookup-virustotal` — community-aggregated detection; complements CrowdStrike's vendor view on the same IOC135- `/lookup-reversinglabs` — vendor-authoritative malware classification + sandbox for a hash136- `/lookup-otx` — community pulse context for the same indicator137- `/threat-actor-profiling` — chains `actor` / `ttps` / `reports` into a full adversary profile138- `/ip-investigation`, `/domain-investigation`, `/hash-investigation`, `/url-investigation` — chain the `indicator` lookup139- `/mitre-attack` — resolve the `technique_ids` from `ttps` against the local ATT&CK dataset140- `/score-source` — apply the Admiralty rating to the result141142## See also143144- Integration setup: `tools/integrations/crowdstrike.md`145- Python CLI source: `tools/clis/crowdstrike.py`146- Companion API reference (non-invokable): `skills/crowdstrike-api/SKILL.md`147- Official API docs: https://developer.crowdstrike.com/api-reference/collections/intel/148- SDK source: https://github.com/CrowdStrike/falconpy