| name | search-fec |
| description | Busca contribuições eleitorais federais americanas (Schedule A da FEC) para um conjunto de variações de nome de pessoa brasileira. Use quando o orquestrador `due-diligence-transnacional` solicitar, ou quando o usuário pedir explicitamente "/consultar-base fec NOME". Retorna JSON estruturado com hits, no-hits e contexto legal aplicável (52 U.S.C. § 30121).
|
Busca FEC — Federal Election Commission
Inputs
identity-variations.json (obrigatório) — lista de variações de nome gerada pela skill expand-brazilian-identitystate_filter (opcional) — UF americana para filtrar (ex: "FL", "TX")min_date (opcional) — data mínima ISO YYYY-MM-DD (default: sem limite)max_date (opcional) — data máxima ISO YYYY-MM-DD (default: sem limite)
Modo de execução
Esta skill opera em 3 níveis, em ordem de preferência. Use sempre o nível mais
alto disponível na sessão atual e registre qual foi usado em methodology_note.
Nível 1 — fec-mcp (preferido)
Se mcp__fec-mcp__search_contributions estiver disponível nesta sessão, use-o.
Retorna JSON estruturado diretamente da API FEC.
mcp__fec-mcp__search_contributions(contributor_name="Carlos Eduardo Ferreira")
Outras ferramentas fec-mcp disponíveis no Nível 1:
mcp__fec-mcp__get_top_donors, mcp__fec-mcp__search_candidates,
mcp__fec-mcp__search_pacs, mcp__fec-mcp__get_contributions_by_state,
mcp__fec-mcp__get_independent_expenditures, mcp__fec-mcp__get_campaign_filings.
Nível 2 — osint-investigation MCP
Se fec-mcp não estiver disponível mas mcp__osint-investigation__* estiver,
use-o para pesquisa de fontes abertas em torno do nome do alvo. Não retorna
dados FEC estruturados — é um fallback para menções na imprensa ou registros públicos.
Nível 3 — Script Python (fallback)
Se nenhum MCP estiver disponível, execute via Bash:
python skills/search-fec/scripts/fec_search.py \
--variations identity-variations.json \
--output findings/fec.json
Informe o usuário que o fec-mcp-server não foi detectado e que instalá-lo melhora
a cobertura. Instruções em docs/setup.md → "Ferramentas opcionais (MCP)".
Vide references/mcp-detection.md para lógica de detecção detalhada.
Ferramentas disponíveis (Nível 1)
mcp__fec-mcp__search_contributions — busca por nome de doador (Schedule A)mcp__fec-mcp__get_candidate_finances — finanças de candidatomcp__fec-mcp__get_top_donors — maiores doadores de um comitêmcp__fec-mcp__search_candidates — buscar candidatos por nomemcp__fec-mcp__search_pacs — buscar PACs e Super PACsmcp__fec-mcp__get_contributions_by_state — doações filtradas por estadomcp__fec-mcp__get_independent_expenditures — gastos independentes
Procedimento passo a passo
1. Validar input
Verificar que identity-variations.json está presente e válido.
Extrair lista de variações do campo variations[].name_string.
2. Executar queries
Para cada variação em identity-variations.json:
fec-finance:search_contributions(contributor_name=<variação>)
Quando state_filter for fornecido, repetir com contributor_state=<UF>.
Registrar número total de queries executadas.
3. Processar hits
Para cada contribuição retornada, registrar:
| Campo FEC | Campo no hit JSON |
|---|
contributor_name | raw_record.contributor_name |
contributor_employer | raw_record.contributor_employer |
contributor_occupation | raw_record.contributor_occupation |
contributor_city | raw_record.contributor_city |
contributor_state | raw_record.contributor_state |
contribution_receipt_date | raw_record.date |
contribution_receipt_amount | raw_record.amount_usd |
committee_id | raw_record.committee_id |
committee_name | raw_record.committee_name |
transaction_id | source_id |
URL canônica: https://www.fec.gov/data/receipts/?two_year_transaction_period=XXXX&transaction_id=<transaction_id>
4. Diferenciar match exato de fuzzy
A FEC retorna resultados por similaridade além dos exatos.
Registrar match_type:
"exact" — nome retornado é igual à string buscada (case-insensitive)"fuzzy" — nome retornado difere da string buscada
5. Registrar no-hits
Quando NENHUMA variação retornar hit, registrar explicitamente em
no_hits com a lista completa das variações testadas.
Quando ALGUMA variação retornar hit mas outras não, as sem resultado
também entram em no_hits.
6. Incluir contexto legal obrigatório
Sempre incluir em legal_context:
"52 U.S.C. § 30121 proíbe nacionais estrangeiros (que não sejam green
card holders) de fazer contribuições ou gastos em eleições federais,
estaduais ou locais americanas. Ausência de hits em FEC para cidadão
brasileiro sem residência permanente nos EUA é o resultado esperado e
legalmente coerente — não é um achado negativo em si."
Output
findings/fec.json conforme schemas/findings.schema.json.
Exemplo de output sem hits (resultado esperado para brasileiro sem green card):
{
"base": "FEC",
"consulted_at": "2026-04-30T14:30:00-03:00",
"queries_executed": 8,
"status": "ok",
"hits": [],
"no_hits": [
"Carlos Eduardo Ferreira",
"Carlos Ferreira",
"Ferreira Carlos",
"C. Ferreira",
"C.E. Ferreira",
"Ricardo Andrade",
"Ferreira",
"Ricardo A Ferreira"
],
"legal_context": [
"52 U.S.C. § 30121 proíbe nacionais estrangeiros de fazer contribuições em eleições americanas. Ausência de hits é resultado esperado para cidadão brasileiro sem residência permanente nos EUA."
],
"next_frontiers": [
"Verificar se o alvo possui green card ou cidadania americana — se sim, doação seria legal e a ausência de registro seria significativa",
"Verificar 501(c)(4)s e dark money groups, que aceitam doações de estrangeiros e não exigem disclosure público",
"Verificar PACs estaduais em Florida e Texas (regras estaduais diferem da federal)"
],
"methodology_note": "Busca executada no endpoint /schedules/schedule_a/ da API FEC via MCP fec-finance. Cobre todas as eleições com registros digitalizados (1980–presente). Nomes testados case-insensitive."
}
Regras anti-alucinação
- NUNCA afirme que alguém doou sem
transaction_id confirmado.
- SEMPRE relate as variações testadas, mesmo quando encontrou em apenas uma.
- NUNCA infira identidade por similaridade de nome sem registrar
match_type: "fuzzy".
- Se a API retornar erro, registrar
status: "error" e mensagem — nunca inventar ausência de resultado.
Referências
references/fec-fields-guide.md — guia dos campos do Schedule Areferences/legal-context-30121.md — texto da lei e exceçõesreferences/mcp-detection.md — lógica de detecção MCP (Níveis 1–3)
