Filed — US Business Entity Search

Search and retrieve US business entity data (LLCs, corporations, partnerships) from official Secretary of State records via the Filed.dev API. Use when looki...

Security Scan

The skill is internally consistent with its stated purpose: it queries the Filed.dev API and only requests the single FILED_API_KEY credential and curl; nothing in the files indicates unrelated access or exfiltration.

Purpose & Capability

Name/description match the included script and docs. The only required credential is FILED_API_KEY and the declared required binary is curl, both appropriate for an HTTP API client to filed.dev.

Instruction Scope

SKILL.md and scripts/filed.sh stick to search and entity retrieval from filed.dev. The script reads only FILED_API_KEY (declared). Note: the script optionally uses python3 for URL encoding and jq for output formatting if present, but those are not listed in required bins; the script falls back to simpler behavior if they are absent. Also avoid passing the API key on the command line (the script supports --api-key), since command-line args can be recorded in shell history or process lists.

Install Mechanism

This is instruction-only with an included shell script; there is no install spec, no downloads, and nothing is written to disk beyond the script itself. Low install risk.

Credentials

Only FILED_API_KEY is required (declared as primaryEnv). No other credentials or unrelated environment variables are requested. That is proportionate to the described functionality.

Persistence & Privilege

always:false and normal user-invocable/autonomous invocation defaults. The skill does not request persistent system privileges, nor does it modify other skills or system-wide configs.

Assessment

This skill appears to do only what it claims: query the Filed.dev API using FILED_API_KEY and curl. Before installing, verify you trust filed.dev and are comfortable sending business-query payloads to that service. Prefer setting FILED_API_KEY in your environment rather than passing it on the command line (to avoid shell history / process-list exposure). Be aware the script will use python3 and jq if present for URL-encoding and pretty output (they are optional), and test the script in a safe environment first. If you need higher assurance, confirm the filed.dev domain, pricing, and privacy policy before provisioning an API key.

Filed — Business Entity Lookup

Search 1.9M+ US business entities from official state records.

Setup

An API key is required. Get one free (100 lookups/month) at https://filed.dev/register

Store the key in environment variable FILED_API_KEY or pass via --api-key.

Quick Reference

# Search by business name
scripts/filed.sh search --name "Acme Holdings" --state FL

# Search by registered agent
scripts/filed.sh search --agent "CSC Global" --state FL

# Search by officer name
scripts/filed.sh search --officer "John Smith" --state NY

# Get full entity details (officers, filings, addresses)
scripts/filed.sh entity ent_mNqR7xKp

# Filter by status and type
scripts/filed.sh search --name "Acme" --state FL --status active --type llc

# Filter by formation date
scripts/filed.sh search --name "Acme" --state FL --formed-after 2020-01-01

Supported States

FL, NY, PA, CT, CO, OR, IA, AK — more added regularly.

Response Fields

Search results return: id, name, state, type, status, formedDate, registeredAgent (name + address), principalAddress, officerCount.

Entity details add: stateEntityId, officers[] (name + title), filings[] (type + date).

Paid Plans

Plan	Lookups/month	Price
Free	100	$0
Pro	1,000	$49/mo
Ultra	10,000	$199/mo
Mega	50,000	$499/mo

Upgrade at https://filed.dev/pricing or via RapidAPI: https://rapidapi.com/grantley-holdings-grantley-holdings-default/api/filed2

API Details

For full endpoint docs, parameter reference, and error codes: references/api-docs.md