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.

Ver en apify.com

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 en 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: 4 usuarios totales, 2 usuarios mensuales, 100.0% de ejecuciones exitosas, 0 marcadores
  • Calificación de usuarios: Sin calificaciones aún

Precios

desde $2.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. Dado que este Actor admite descuentos de la Tienda Apify, el precio disminuye cuanto mayor sea tu plan de suscripción.

Más información: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

¿Qué es un Apify Actor?

Un Actor es un programa en la nube sin servidor que se ejecuta en la plataforma Apify. Tiene dos modos de ejecución. 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.

El vocabulario de Apify y el modelo de plataforma se definen una vez, en el inicio rápido del agente en https://apify.com/agents.md.

¿Cómo integrar un Actor?

Si te preguntan sobre integración, ayudas a los desarrolladores a integrar Actores en sus proyectos. Te adaptas a su stack y entregas integraciones seguras, bien documentadas y listas para producción.

No adivines una ruta de integración. Cada una de ellas está en el inicio rápido del agente en https://apify.com/agents.md:: el servidor MCP de Apify, Agent Skills con la CLI de Apify, los clientes de JavaScript y Python, la API REST y la ruta sin cuenta para un agente sin humano que inicie sesión. También incluye la regla sobre indicar el costo antes de la primera ejecución pagada.

Para ejemplos ya conectados al esquema de entrada de este Actor, consulta la sección API a continuación.

Cada biblioteca de cliente tiene documentación de referencia que el inicio rápido no repite: JavaScript/TypeScript (npm install apify-client) y Python (pip install apify-client).

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 las presentaciones enviadas desde 2001. Refleja todos los filtros disponibles en el formulario de búsqueda: consulta por palabras clave, empresa/ticker/CIK, tipo de formulario de presentación, rango de fechas de presentación, ubicación de la 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

  1. Implementa este Actor en Apify (o vincula este repositorio de Git) e inicia una ejecución en modo Standby.

  2. Conecta tu cliente MCP a https://<your-actor>.apify.actor/mcp usando el transporte HTTP Streamable, pasando tu token de API de Apify como token Bearer en el encabezado Authorization.

    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_TOKEN con tu token de API de Apify. Verifica que se haya conectado con claude mcp list.

  3. Llama a search_edgar_filings con una consulta de palabras clave y cualquier combinación de filtros (formularios, rango de fechas, ubicación, código SIC, entidad).

  4. Opcionalmente, llama a lookup_edgar_company primero para resolver un nombre/ticker de empresa difuso a la cadena de entidad exacta o CIK.

  5. Usa get_edgar_filing_index y get_edgar_filing_document para 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-Agent descriptivo 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 recorrer 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 utiliza 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_results con moderación — cada página de 100 resultados es una solicitud upstream; la tarifa de 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 completamente de SEC EDGAR; verifica siempre contra la presentación original 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

{}

Esquema de salida del Actor

server (tipo: string):

Este Actor se ejecuta como servidor en lugar de producir filas de conjunto de datos. Inícialo en modo Standby y llama a esta URL; el registro de la ejecución registra cada solicitud.

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/uTJ689bIHDhdmWTZc/openapi.json