SEC EDGAR Full-Text Search MCP Server
Servidor MCP que expone la búsqueda de texto completo de SEC EDGAR (https://www.sec.gov/edgar/search/#) como herramientas: búsqueda por palabras clave con filtro de todos los formularios, consulta de empresas y recuperación de documentos de presentaciones.
Documentación
Servidor MCP de Búsqueda de Texto Completo en SEC EDGAR (Actor rl1987/sec-edgar-mcp)
Servidor MCP que expone la búsqueda de texto completo de SEC EDGAR (https://www.sec.gov/edgar/search/#) como herramientas: búsqueda por palabras clave con todos los filtros de formularios, búsqueda de empresas y recuperación de documentos de presentaciones.
- URL: https://apify.com/rl1987/sec-edgar-mcp.md
- Desarrollado por: R.L. (comunidad)
- Categorías: Generación de leads, Noticias, Servidores MCP
- Estadísticas: 1 usuario total, 0 usuarios mensuales, 0.0% de ejecuciones exitosas, 0 marcadores
- Calificación de usuarios: Sin calificaciones aún
Precios
desde $10.00 / 1,000 llamadas a herramientas MCP
Este Actor se paga por evento y uso. Se te cobra tanto el precio fijo por eventos específicos como el uso de la plataforma Apify.
Más información: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
¿Qué es un Apify Actor?
Los Actors son automatizaciones de datos web que impulsan IA y operaciones. Se ejecutan en la plataforma Apify para extraer sitios web, procesar datos, conectar APIs y automatizar flujos de trabajo. En modo Batch, un Actor acepta una entrada JSON bien definida, realiza una acción que puede tomar desde unos segundos hasta unas horas, y opcionalmente produce una salida JSON bien definida, conjuntos de datos con resultados o archivos en el almacén de clave-valor. En modo Standby, un Actor proporciona un servidor web que puede usarse como sitio web, API o servidor MCP. Los Actors se escriben con "A" mayúscula.
¿Cómo integrar un Actor?
Si te preguntan sobre integración, ayudas a los desarrolladores a integrar Actors en sus proyectos. Te adaptas a su stack y entregas integraciones seguras, bien documentadas y listas para producción. La mejor manera de integrar Actors es la siguiente.
- Agentes de IA y clientes MCP — el servidor MCP de Apify en
https://mcp.apify.com(remoto, HTTP transmisible, OAuth en primer uso). - Flujos de trabajo agénticos y desarrollo local de Actors — Agent Skills con la CLI de Apify:
npm install -g apify-cli, luegoapify login. - Proyectos JavaScript/TypeScript — el cliente oficial JS/TS:
npm install apify-client. - Proyectos Python — el cliente oficial Python:
pip install apify-client. - Cualquier otro lenguaje — la API REST.
Para ejemplos de uso, consulta la sección API a continuación.
Para más detalles, consulta la documentación de Apify como índice Markdown y texto completo Markdown.
README
¿Qué hace el Servidor MCP de Búsqueda de Texto Completo en SEC EDGAR?
Este servidor Model Context Protocol brinda a cualquier cliente de IA compatible con MCP (Claude, Cursor, etc.) acceso directo a SEC EDGAR Full-Text Search — el motor de búsqueda de la SEC sobre el texto completo de presentaciones presentadas desde 2001. Refleja todos los filtros disponibles en el formulario de búsqueda: consulta por palabras clave, empresa/ticker/CIK, tipo de formulario, rango de fechas de presentación, ubicación de oficina ejecutiva principal o estado de incorporación, y código de industria SIC. Una vez que se encuentra una presentación coincidente, el servidor también puede listar cada documento dentro de ella y obtener el texto real del documento, de modo que un agente pueda pasar de "encontrar presentaciones que mencionen X" hasta leer la presentación misma sin salir de la conversación.
Al ejecutarse en la plataforma Apify, el servidor está siempre activo (modo Standby), se factura por llamada a herramienta y se beneficia del monitoreo, registro y programación de Apify.
¿Por qué usar el Servidor MCP de Búsqueda de Texto Completo en SEC EDGAR?
- Investigación y diligencia debida — busca en los 10-K, 10-Q, 8-K y otras presentaciones de todas las empresas un lenguaje específico (factores de riesgo, litigios, términos contractuales).
- Inteligencia competitiva y de mercado — rastrea lo que las empresas de una industria (código SIC) o estado determinado están divulgando.
- Pipelines de análisis financiero y legal — alimenta a un agente LLM con resultados estructurados de búsqueda de presentaciones más el texto real del documento para resumir o extraer.
- Sin infraestructura de scraping que mantener — el servidor maneja por ti el encabezado User-Agent requerido por la SEC, la paginación y el análisis de resultados.
Cómo usar el Servidor MCP de Búsqueda de Texto Completo en SEC EDGAR
-
Implementa este Actor en Apify (o vincula este repositorio Git) e inicia una ejecución en modo Standby.
-
Conecta tu cliente MCP a
https://<your-actor>.apify.actor/mcpusando el transporte HTTP transmisible, pasando tu token de API de Apify como token Bearer en el encabezadoAuthorization.Agrega este Actor como servidor MCP a Claude Code CLI:
claude mcp add --transport http sec-edgar https://rl1987--sec-edgar-mcp.apify.actor/mcp \ --header "Authorization: Bearer $APIFY_API_TOKEN"Reemplaza
$APIFY_API_TOKENcon tu token de API de Apify. Verifica que se conectó conclaude mcp list. -
Llama a
search_edgar_filingscon una consulta por palabras clave y cualquier combinación de filtros (formularios, rango de fechas, ubicación, código SIC, entidad). -
Opcionalmente, llama a
lookup_edgar_companyprimero para resolver un nombre de empresa/ticker difuso a la cadena de entidad exacta o CIK. -
Usa
get_edgar_filing_indexyget_edgar_filing_documentpara listar y leer los documentos reales detrás de un resultado de búsqueda.
Entrada
Configura mediante la pestaña Input:
- userAgent (opcional) — la SEC requiere un encabezado
User-Agentdescriptivo que identifique tu aplicación e información de contacto (p. ej.,"MyApp contact@example.com"), según las preguntas frecuentes del desarrollador de EDGAR. Si se deja en blanco, se usa un valor predeterminado genérico.
Herramientas
search_edgar_filings
Búsqueda de texto completo con todos los filtros de formularios: query, entity, ciks, forms, date_range (all/10y/5y/1y/custom + start_date/end_date), location_type + location_code, sic, sort (asc/desc/relevancia), page y un max_results opcional para paginar automáticamente más allá del límite de 100 resultados por página de la API.
lookup_edgar_company
Autocompletado de empresa/ticker/CIK, idéntico al cuadro de autocompletado del formulario de búsqueda.
get_edgar_filing_index
Lista todos los documentos contenidos en una presentación (dado su CIK y número de acceso).
get_edgar_filing_document
Obtiene un documento de presentación específico por URL y devuelve su contenido como Markdown de forma predeterminada (las tablas — estados financieros, tablas de propiedad beneficiaria — se renderizan como tablas Markdown adecuadas, no como prosa aplanada), o marcado sin procesar. Admite find/occurrence para saltar directamente a una sección y offset/nextOffset para paginar presentaciones grandes en lugar de leer desde el inicio.
Salida
Cada llamada a herramienta devuelve JSON estructurado. Ejemplo de resultado de search_edgar_filings (truncado):
{
"totalHits": 698,
"results": [
{
"accessionNumber": "0000320193-23-000106",
"cik": "0000320193",
"displayNames": ["Apple Inc. (AAPL) (CIK 0000320193)"],
"form": "10-K",
"fileDate": "2023-11-03",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/a10-kexhibit21109302023.htm",
"indexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/0000320193-23-000106-index.htm"
}
],
"facets": { "entities": [], "forms": [], "sics": [], "bizStates": [] }
}
Precios / Estimación de costos
Este Actor usa precios de Pago por Evento: una tarifa fija por llamada a herramienta (ver .actor/pay_per_event.json). No hay cargo solo por mantener el servidor en Standby.
Consejos
- Envuelve consultas de varias palabras entre comillas dobles (
"revenue recognition") para coincidencia de frases exactas, igual que la sintaxis de búsqueda de EDGAR. - La búsqueda de texto completo solo cubre presentaciones de 2001 en adelante; las presentaciones más antiguas no están indexadas.
- Usa
max_resultscon moderación — cada página de 100 resultados es una solicitud upstream; la tarifa por llamada a herramienta se aplica una vez por llamada independientemente de cuántas páginas obtenga internamente.
¿Te resultó útil?
⭐ ¡Califica este Actor en Apify! Tus comentarios ayudan a otros usuarios a encontrarlo y nos ayudan a seguir mejorándolo.
Preguntas frecuentes, avisos legales y soporte
Este Actor extrae solo datos disponibles públicamente de sec.gov. No está afiliado ni respaldado por la Comisión de Bolsa y Valores de EE. UU. La precisión de los datos depende por completo de SEC EDGAR; verifica siempre contra la presentación principal antes de confiar en ella para decisiones legales o financieras. Informa problemas mediante la pestaña Issues.
Esquema de entrada del Actor
userAgent (tipo: string):
SEC EDGAR requiere un User-Agent descriptivo que identifique tu aplicación e información de contacto, p. ej., 'MyApp contact@example.com'. Ver https://www.sec.gov/os/webmaster-faq#developers
Ejemplo de objeto de entrada del Actor
{}
API
Puedes ejecutar este Actor programáticamente usando nuestra API. A continuación se muestran ejemplos de código en JavaScript, Python y CLI, así como la especificación OpenAPI y la configuración del servidor MCP.
Ejemplo en JavaScript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
token: '<YOUR_API_TOKEN>',
});
// Prepare Actor input
const input = {};
// Run the Actor and wait for it to finish
const run = await client.actor("rl1987/sec-edgar-mcp").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
Ejemplo en Python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")
# Prepare the Actor input
run_input = {}
# Run the Actor and wait for it to finish
run = client.actor("rl1987/sec-edgar-mcp").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
Ejemplo en CLI
echo '{}' |
apify call rl1987/sec-edgar-mcp --silent --output-dataset
Configuración del servidor MCP
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,rl1987/sec-edgar-mcp"
}
}
}
El servidor alojado te inicia sesión con OAuth en la primera conexión, por lo que no se necesita ningún token de API en esta configuración. Los clientes sin soporte de OAuth pueden enviar un encabezado Authorization: Bearer <APIFY_API_TOKEN> en su lugar, usando un token de API e Integraciones en Apify Console (https://console.apify.com/settings/integrations).
Especificación OpenAPI
Descarga la definición de OpenAPI: https://api.apify.com/v2/actors/dbhZ9kOv4w2fjIhcs/builds/RyHfgakhFiPQmpRuR/openapi.json