essentras

Configuración de agentes de IA

Essentras en Gemini CLI

Gemini CLI se conecta a Essentras mediante el objeto mcpServers de settings.json. Usa httpUrl para https://essentras.com/api/mcp, porque Gemini CLI interpreta url como una dirección SSE. Essentras no requiere cuenta, clave de API ni OAuth. Gemini busca medios, calcula el precio de una cesta y ejecuta verificadores, y luego te da un enlace de pago para abrir y completar la compra.

Inicio rápido

  1. Añade el servidor

    Ejecuta el comando de abajo. El ámbito por defecto es el proyecto, y -s user lo guarda para todas las carpetas.

  2. Compruébalo

    Ejecuta gemini mcp list, o escribe /mcp en una sesión para ver CONNECTED y las herramientas.

  3. Pregunta y confirma

    Gemini pregunta antes de cada llamada: Proceed once, Always allow this tool, Always allow this server o Cancel.

Configuración de MCP

Se guarda en .gemini/settings.json para el proyecto, o en ~/.gemini/settings.json con -s user.

BASH
gemini mcp add --transport http essentras https://essentras.com/api/mcp

O edita settings.json a mano. httpUrl significa Streamable HTTP, url significa SSE.

JSON
{
  "mcpServers": {
    "essentras": {
      "httpUrl": "https://essentras.com/api/mcp"
    }
  }
}

Ejemplos de prompts

  • Busca en Essentras medios de Brasil por menos de $300.
  • Calcula el precio de msn y yahoo-finance juntos y muéstrame el enlace de pago.
  • ¿Se puede eliminar de Google una reseña que amenaza con extorsión?
  • ¿Una entrevista en un periódico local cuenta para la relevancia en Wikipedia?
  • ¿Cuál es la vía legal para eliminar mi dirección de casa de los resultados de Google?

Qué puede hacer aquí

10 herramientas de solo lectura. Ninguna procesa pagos.

search_outlets

Encuentra medios por país, temática, precio, autoridad o política de enlaces

get_outlet

Consulta 1 medio al detalle

quote_placements

Calcula el precio de una cesta y obtén el enlace de pago

list_services

Lista todos los servicios además de las publicaciones, con su precio

quote_service

Calcula el precio de 1 servicio y obtén la página donde el comprador paga

check_review_removability

¿Se puede eliminar esta reseña de Google según una norma concreta de Google?

check_knowledge_panel_readiness

¿Qué tan preparada está esta persona o marca para un Google Knowledge Panel?

check_wikipedia_notability

¿Cada fuente cuenta para la relevancia en Wikipedia?

find_removal_route

¿Cuál es la vía legal para eliminar de Google un resultado sobre una persona?

check_instagram_recovery_path

¿Cuál es la vía oficial de recuperación de una cuenta de Instagram hackeada, desactivada o bloqueada?

Flujos de trabajo habituales

De la búsqueda por presupuesto al pago

Indica un objetivo, un país y un precio máximo. Gemini llama a search_outlets, después a quote_placements, y muestra las partidas, el posible descuento por volumen y el checkout_url. Abre el enlace, revisa la cesta y paga.

REST sin configuración

Si prefieres no cambiar los ajustes, pide a Gemini que ejecute curl contra https://essentras.com/api/agent/v1. Las llamadas REST no requieren configuración y devuelven el mismo presupuesto y checkout_url.

Revisa un caso

Describe una reseña o una solicitud de eliminación. Gemini llama al verificador con opciones fijas e informa del veredicto y de la norma en la que se basa. El precio del servicio correspondiente, si lo hay, llega después de la vía gratuita.

Consejos para acertar

  • Las herramientas aparecen como mcp_essentras_search_outlets, etc. Evita guiones bajos en los nombres de servidor.
  • Deja trust en false. Si no, se omiten todas las confirmaciones del servidor.
  • Usa includeTools para exponer solo algunas herramientas, como search_outlets y quote_placements.
  • Ejecuta gemini --debug para obtener una salida detallada y pulsa F12 para abrir la consola de depuración.

Preguntas frecuentes

Preguntas frecuentes

¿Debo usar url o httpUrl?▾

Usa httpUrl. En Gemini CLI, httpUrl selecciona el transporte Streamable HTTP y url selecciona SSE. Essentras ofrece Streamable HTTP, así que una entrada con url no es compatible. La opción --transport http de gemini mcp add también selecciona Streamable HTTP, así que ambas sirven.

Me he pasado a Antigravity CLI. ¿Funciona Essentras?▾

Antigravity CLI lee los servidores MCP de ~/.gemini/config/mcp_config.json, o de .agents/mcp_config.json en un proyecto, dentro de mcpServers. Su documentación indica que los campos heredados url y httpUrl no son compatibles. Usa serverUrl con https://essentras.com/api/mcp y escribe /mcp para abrir el gestor. Essentras tampoco requiere iniciar sesión ahí.

¿Puede Gemini CLI pagar una publicación?▾

No. quote_placements devuelve un checkout_url. Tú lo abres, revisas la cesta y el total, y autorizas el pago. La tarjeta se cobra al realizar el pedido, y se reembolsa si la publicación no se realiza o no se cumple el plazo de entrega.

¿Gemini CLI necesita OAuth para Essentras?▾

No. Gemini CLI inicia un flujo OAuth cuando un servidor responde 401 Unauthorized, y ese flujo requiere un navegador local. Essentras es público y no pide credenciales, así que no hay paso por el navegador ni token que guardar.

Solución de problemas

Essentras aparece como DISCONNECTED en /mcp

Comprueba que has usado httpUrl, no url, y que la URL es exactamente https://essentras.com/api/mcp. Ejecuta gemini mcp list para ver el detalle del error.

No aparece ningún error al iniciar

Gemini CLI silencia por defecto los errores de conexión MCP en segundo plano y muestra 1 aviso. Ejecuta /mcp list o gemini mcp list.

Error 429 o rate_limited

Essentras permite 120 solicitudes MCP por IP por minuto. Espera unos 60 segundos y vuelve a intentarlo.

Referencia

¿Listo para calcular precios de medios y servicios con Gemini CLI?

Busca entre más de 3,800 medios, calcula el precio de una cesta o un servicio y entrega el pago al comprador. Sin necesidad de cuenta.

Explorar mediosLeer agents.md