Collegare SEC EDGAR MCP a Gemini CLI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → SEC EDGAR, installalo senza chiave, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

SEC EDGAR + Gemini

Documenti e dati finanziari di SEC EDGAR, l'archivio dell'autorità di borsa statunitense, gratis e senza chiave: trova il CIK di un'azienda, leggi profilo e storico dei depositi (10-K, 10-Q, 8-K, Form 4), ottieni i valori XBRL di bilancio per concetto, confronta aziende con i frame, cerca nel testo completo dei documenti dal 2001 ed elenca i file di un deposito. Serve solo uno User-Agent con un contatto.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SEC_EDGAR_USER_AGENT (un nome e un indirizzo e-mail di contatto, non una chiave)

Step 1 — Configura il connettore

Gratis, senza chiave, una sola impostazione: la configurazione richiede circa un minuto. Il connettore legge le API pubbliche EDGAR della U.S. Securities and Exchange Commission: profili, storici dei depositi e dati finanziari XBRL da https://data.sec.gov, ricerca nel testo completo e ricerca aziende da https://efts.sec.gov, e cartelle dei depositi dall'archivio EDGAR su https://www.sec.gov. Non servono account né chiavi.

1. Le regole della SEC chiedono che ogni richiesta automatica dichiari chi la invia, con un'e-mail di contatto, nell'header User-Agent; le richieste senza vengono bloccate con 403. Inserisci in SEC_EDGAR_USER_AGENT la tua organizzazione o il tuo nome e un indirizzo e-mail a cui la SEC può contattarti, per esempio Example Research LLC [email protected].
2. Installa il connettore. Non c'è nessun passaggio Authorize with Provider.
3. Verificalo con sec_edgar_full_text_search e forms 10-K: elenca le relazioni annuali depositate più di recente.

CIK: ogni soggetto che deposita ha un Central Index Key. I tool di data.sec.gov lo vogliono completato a 10 cifre con zeri iniziali (0000320193 per Apple); sec_edgar_get_filing_index lo accetta anche senza zeri. sec_edgar_search_companies trasforma un nome o un ticker nel CIK: NVDA dà 1045810, cioè 0001045810.

Cosa legge: ogni soggetto registrato presso la SEC, comprese le società quotate negli USA, gli emittenti esteri, i fondi e gli insider.

• Fino a 10 soggetti corrispondenti a un nome o un ticker, con CIK, nome e ticker.
• Il profilo di un soggetto: nome, ticker, borse, settore SIC, chiusura dell'esercizio, stato di costituzione, indirizzi e nomi precedenti, più i suoi 100 depositi più recenti con accession number, modulo (10-K, 10-Q, 8-K, 4, DEF 14A e altri), data di deposito, data di riferimento e documento principale. Lo storico più vecchio arriva dai file elencati in olderFilingFiles.
• Dati finanziari XBRL: i nomi di tutti i concetti che un'azienda dichiara (us-gaap, ifrs-full, dei, srt), poi tutti i valori di un concetto, per esempio us-gaap NetIncomeLoss in USD. I ricavi sono spesso Revenues o RevenueFromContractWithCustomerExcludingAssessedTax a seconda dell'azienda, quindi l'AI controlla prima l'elenco dei concetti.
• Confronti tra aziende con i frame: un concetto per un periodo di calendario, i 250 valori più alti con CIK, azienda, sede e fine periodo. CY2024 è un anno intero, CY2024Q3 un trimestre e CY2024Q4I una data di bilancio.
• Ricerca nel testo completo dei documenti dal 2001, per parole o "frase esatta", tipi di modulo, startdt e enddt, ciks o entityName e sede. Senza q elenca gli ultimi depositi di un modulo, come gli 8-K di oggi.
• I documenti di un deposito: nomi file, tipi e dimensioni del documento principale, degli allegati, dei file XBRL e del testo completo della submission.

Formati dei dati: in recentFilings le liste sono parallele: la voce n di accessionNumber, form, filingDate, reportDate e primaryDocument descrive lo stesso deposito, dal più recente. I valori XBRL sono nell'unità indicata (USD, shares, USD-per-shares), non in migliaia. fy e fp (FY, da Q1 a Q4) sono l'esercizio e il periodo del deposito che ha riportato il valore, mentre start ed end danno il periodo effettivo. Lo stesso periodo compare in più depositi, perché un 10-K ripete gli anni precedenti: per avere un valore per periodo l'AI preferisce le voci con un frame (es. CY2024). I valori trimestrali dei 10-Q possono essere cumulati da inizio anno, quindi confronta start ed end. Il link a un documento è https://www.sec.gov/Archives/edgar/data/<cik>/<accession without dashes>/<file name>; l'id di un risultato della ricerca testuale è <accession>:<file name>.

Paginazione: la ricerca nel testo completo restituisce 100 risultati per pagina; l'AI prosegue con from a passi di 100, fino a 10.000 risultati per ricerca, quindi restringe per modulo e data. Lo storico dei depositi si scorre tramite olderFilingFiles.

Solo lettura: ogni tool legge soltanto, quindi non c'è nulla da confermare e nessun tool è disattivato all'installazione.

Limiti: al massimo 10 richieste al secondo per mittente. Oltre, la SEC blocca l'indirizzo per circa 10 minuti.

Errori comuni: 403 significa che lo User-Agent manca o non è accettato, oppure che il limite di frequenza è stato superato. 404 significa un CIK, un concetto, un'unità o un periodo sconosciuti; non tutte le aziende dichiarano tutti i concetti.

Il connettore non scarica gli archivi ZIP completi né il file company_tickers.json da 1 MB, non legge i documenti completi dei depositi (spesso megabyte di HTML) e non deposita documenti. Gli endpoint di ricerca testuale e ricerca aziende su efts.sec.gov alimentano il sito EDGAR e non fanno parte dell'API documentata della SEC, quindi possono cambiare.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di SEC EDGAR.

Tool disponibili

Esempi di prompt

• "Quali sono stati i ricavi annuali e l’utile netto di NVIDIA negli ultimi cinque esercizi, secondo i depositi SEC?"
• "Elenca gli 8-K depositati da Tesla quest'anno, con data e documento principale."
• "Quali 10 aziende hanno dichiarato il totale attivo più alto a fine 2024?"
• "Trova i 10-K dal 2023 che citano "tariff exposure" e dimmi di quali aziende sono."
• "Mostrami i Form 4 degli insider di Apple dell'ultimo mese con i link ai documenti."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot