FirmLens
FirmLens crea directorios buscables generados a partir de datos web e IA.
Servidor MCP alojado
npx add-mcp 'https://mcp.firmlens.io/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
El servidor MCP de FirmLens
Pídele a Claude que "encuentre instaladores solares en Alemania que hagan trabajos de EPC" y obtén empresas reales, con sus proyectos y detalles. El servidor MCP de FirmLens conecta a Claude, ChatGPT o cualquier otro cliente MCP con nuestros directorios, para que tu agente pueda buscar empresas, filtrarlas por campo y leer sus sitios web rastreados desde dentro de una conversación.
Dirección del servidor
Apunta tu cliente al endpoint HTTP Streamable:
https://mcp.firmlens.io/mcp
Los clientes que solo hablan el transporte SSE más antiguo pueden conectarse a https://mcp.firmlens.io/sse en su lugar.
Inicia sesión o usa una clave API
Hay dos formas de conectarse. Ambas usan tu cuenta gratuita de FirmLens y sus créditos.
Inicia sesión con tu cuenta de FirmLens. Los clientes que admiten el inicio de sesión MCP, como Claude y ChatGPT, solo necesitan la dirección del servidor. Cuando la agregas, abren una página de inicio de sesión de FirmLens donde inicias sesión con tu correo electrónico y contraseña habituales y apruebas la conexión. No hay nada que copiar o pegar, y tu clave API nunca sale de FirmLens. Tu cuenta necesita una dirección de correo electrónico verificada.
Cada aplicación que conectes de esta manera aparece en Aplicaciones conectadas en tu página de cuenta. Desconéctala allí y pierde el acceso de inmediato. Restablecer tu contraseña las desconecta todas.
O pasa tu clave API como encabezado. Para Claude Code, tus propios agentes y cualquier cliente sin inicio de sesión, envía tu clave API de FirmLens con cada solicitud en el encabezado x-api-key. El servidor no la almacena; la reenvía a la API de FirmLens.
x-api-key: YOUR_FIRMLENS_API_KEY
Si tu cliente solo puede enviar un token de portador, eso también funciona:
Authorization: Bearer YOUR_FIRMLENS_API_KEY
Cada cuenta verificada de FirmLens viene con una clave API. Encuentra la tuya en tu página de cuenta; ¿aún no tienes cuenta? Crea una gratis.
Trata la clave como una contraseña. Mantenla en la configuración de tu cliente y no la pegues en un mensaje o en un archivo compartido. Una solicitud sin inicio de sesión ni clave se rechaza con 401 Unauthorized.
Conecta tu agente
Claude (claude.ai y la aplicación de escritorio): abre Configuración, luego Conectores, y elige Agregar conector personalizado. Ingresa https://mcp.firmlens.io/mcp e inicia sesión con tu cuenta de FirmLens cuando se te pida.
ChatGPT: abre Configuración, luego Aplicaciones y conectores, y en Configuración avanzada activa el Modo desarrollador. De vuelta en Aplicaciones y conectores, elige Crear, nombra el conector FirmLens, ingresa https://mcp.firmlens.io/mcp como URL del servidor y elige OAuth como autenticación. ChatGPT te envía a FirmLens para iniciar sesión y aprobar. El Modo desarrollador depende de tu plan de ChatGPT, y los nombres de los menús pueden variar ligeramente entre versiones de ChatGPT.
Claude Code agrega el servidor y su encabezado en un solo comando:
claude mcp add --transport http firmlens https://mcp.firmlens.io/mcp \
--header "x-api-key: YOUR_FIRMLENS_API_KEY"
OpenAI Agents SDK y Responses API: la herramienta MCP alojada se conecta con tu clave API en un encabezado. En Python:
from agents import Agent, HostedMCPTool
firmlens = HostedMCPTool(tool_config={
"type": "mcp",
"server_label": "firmlens",
"server_url": "https://mcp.firmlens.io/mcp",
"headers": {"x-api-key": "YOUR_FIRMLENS_API_KEY"},
"require_approval": "never",
})
agent = Agent(name="Researcher", tools=[firmlens])
Otros clientes que leen una configuración JSON toman una entrada como esta. Dónde vive la lista de servidores y cómo se llaman sus claves difiere un poco entre clientes, así que revisa el tuyo. Si tu cliente admite el inicio de sesión MCP, omite los encabezados y te pedirá que inicies sesión en su lugar:
{
"mcpServers": {
"firmlens": {
"url": "https://mcp.firmlens.io/mcp",
"headers": {
"x-api-key": "YOUR_FIRMLENS_API_KEY"
}
}
}
}
Una vez conectado, pregúntale a tu agente algo como "Encuentra instaladores solares en Alemania que hagan trabajos de EPC". Comienza con list_directories para ver qué puede buscar.
Herramientas
Las búsquedas en directorios cubren los directorios de energía renovable, concesionarios de automóviles y ciberseguridad. Cada resultado lleva un refId que tu agente puede pasar a web_cache_search_match para leer las páginas rastreadas de esa empresa.
| Herramienta | Qué hace | Créditos |
|---|---|---|
| list_directories | Lista los directorios que puedes buscar | Gratis |
| get_search_fields | Lista los campos buscables de un directorio | Gratis |
| get_stats | Tu cuota restante y conteos de llamadas | Gratis |
| search | Búsqueda de texto libre en todos los campos de un directorio | 1 por resultado |
| search_match | Busca campos específicos, opcionalmente como coincidencia exacta | 1 por resultado |
| search_match_multiple | Una consulta diferente por campo, todas deben coincidir | 1 por resultado |
| search_fields_exists | Empresas que tienen datos en los campos dados | 1 por resultado |
Las herramientas web funcionan en cualquier sitio web rastreado, no solo en empresas de directorios:
| Herramienta | Qué hace | Créditos |
|---|---|---|
| get_web_info | URL resuelta, direcciones IP y fecha del último rastreo de un sitio web | 1 |
| get_web_data | Datos extraídos de un sitio web, incluidos datos de schema.org | 1 |
| web_cache_search | Búsqueda de texto completo en páginas rastreadas | 1 |
| web_cache_search_match | Busca un campo de página; con refId, las páginas rastreadas de una empresa | 1 |
Créditos y límites
Los créditos se cargan a tu cuenta de FirmLens, ya sea que te conectes iniciando sesión o con tu clave API. Las búsquedas en directorios cuestan 1 crédito por empresa devuelta, por lo que una página de 3 empresas cuesta 3 créditos y una página de 100 cuesta 100. Una búsqueda devuelve hasta 100 empresas, y tu cuota restante debe cubrir el tamaño de página que solicites. Las herramientas de datos web cuestan 1 crédito por llamada. Tu agente puede verificar tu cuota restante gratis con get_stats.
¿Te estás quedando sin créditos? Recarga en tu página de cuenta. Los créditos son un pago único con tarjeta a través de Stripe, con IVA agregado al finalizar la compra cuando corresponda. Se agregan a tu saldo dentro de un minuto después del pago y no caducan.
Cada clave o cuenta con inicio de sesión puede hacer ráfagas de hasta 60 solicitudes, reabastecidas a 2 por segundo. Más allá de eso, el servidor responde 429 Too Many Requests hasta que se reabastece la asignación.
¿Preguntas o necesitas un límite más alto? Ponte en contacto.