Cómo usar DeepSeek Search en Goose Desktop y CLI

¿Prefieres que un asistente prepare la configuración? Comparte esta guía con Goose y pídele que revise primero tus extensiones actuales, prepare la entrada del adaptador y deje que tú introduzcas la clave en el campo local de secretos. No pegues la clave en la conversación.

Use this guide to add DeepSeek Search to Goose. Inspect my existing extension
configuration first and preserve it. Add the local adapter as a stdio MCP
extension, read the API key from a private env file or Goose's extension
secrets, and keep it disabled by default until I choose a session. Do not
print the secret or make any billable request without my approval. Show me how
to verify Search and Fetch.

Goose trata un servidor MCP como una extensión, así que puedes mantenerlo en la lista de extensiones, activarlo solo en determinadas sesiones o adjuntarlo a una única ejecución de la CLI. Esta última opción resulta práctica para consultas ocasionales porque no modifica el conjunto de extensiones predeterminado. Goose ofrece tanto un administrador de extensiones para la aplicación de escritorio como goose configure en la CLI. Documentación de extensiones de Goose

Instala el adaptador una sola vez

DeepSeek Search es una API HTTP. Para que Goose pueda invocarla como dos herramientas independientes, utiliza el adaptador MCP local y el ayudante de terminal descritos en la guía de DeepSeek Search para Claude Code. Instala las dependencias fijadas en un directorio privado con Node.js 22 o posterior. Guarda DEEPSEEK_API_KEY=... en un archivo de entorno privado; no escribas la clave en el YAML de Goose ni en un proyecto compartido.

Para una instalación persistente, el archivo ~/.config/goose/config.yaml de Goose admite un mapa extensions. Integra esta entrada en el archivo existente y sustituye las rutas de ejemplo por rutas absolutas reales:

extensions:
  deepseek-search:
    name: DeepSeek Search
    cmd: node
    args:
      - --env-file=/Users/you/.config/deepseek-search/.env
      - /Users/you/.local/share/deepseek-search/server.mjs
    enabled: false
    type: stdio
    timeout: 60

enabled: false evita que la extensión se cargue automáticamente en cada sesión nueva. Es un servidor MCP local por entrada/salida estándar, así que la configuración no requiere un complemento específico para la API. La documentación de Goose describe los campos cmd, args, type, enabled y timeout para las extensiones stdio. Configuración de extensiones de Goose

Elige dónde quieres habilitarla

En Goose Desktop, abre Extensions, selecciona Add custom extension e introduce el comando y los argumentos del adaptador como una extensión Standard IO. Añade la variable de entorno solo si decides inyectar la clave desde el formulario de la extensión; en caso contrario, indica la ruta al archivo de entorno en los argumentos del comando. Elige un tiempo de espera razonable y guarda. Después puedes activar o desactivar la extensión desde el panel Extensions.

En Goose CLI, ejecuta goose configure, elige Add Extension y luego Command-Line Extension. Puedes asignarle el ID deepseek-search, usar node como comando y añadir cada argumento por separado. Si la extensión permanece desactivada en la lista predeterminada, actívala mediante Toggle Extensions cuando quieras usarla en sesiones futuras. Configuración de extensiones en Goose CLI

Para una sola sesión no hace falta instalar una extensión predeterminada persistente. La CLI actual permite iniciar una sesión con un comando local de extensión:

goose session --with-extension "deepseek-search: node --env-file=/Users/you/.config/deepseek-search/.env /Users/you/.local/share/deepseek-search/server.mjs"

La referencia de la CLI de Goose documenta --with-extension para extensiones stdio y también ofrece --with-streamable-http-extension para puntos de conexión MCP remotos. Este adaptador es un proceso stdio local, así que utiliza --with-extension. Comandos de Goose CLI

Decide si DeepSeek Search debe cargarse de forma predeterminada o solo en las sesiones que elijas.

Comprueba que Goose detecta las herramientas antes de hacer una llamada de pago

Inicia una sesión nueva de Goose con la extensión habilitada y pídele que muestre las herramientas DeepSeek disponibles. El adaptador debería exponer deepseek_search y deepseek_fetch. A continuación, pídele una búsqueda acotada sobre documentación oficial, que recupere una de las páginas y que cite la URL obtenida en la respuesta final.

Goose permite cambiar la disponibilidad de las extensiones durante una sesión, pero distingue entre los cambios que solo afectan a la sesión actual y los valores predeterminados para futuras sesiones. Comprueba el interruptor de la sesión actual en vez de suponer que editar la configuración ha modificado un chat que ya estaba abierto. Que la extensión se inicie correctamente solo demuestra que Goose puede arrancar el adaptador y descubrir las herramientas; no acredita la autenticación con DeepSeek. Para una llamada en vivo necesitas tu propia clave y podrían aplicarse los precios vigentes de la API Search y Fetch de DeepSeek.

Una conexión de extensión correcta no significa que se haya enviado una solicitud a la API en vivo de DeepSeek.

Usa el ayudante de CLI si Goose no necesita herramientas

Para una investigación manual, puedes usar la utilidad compartida search-cli.mjs del tutorial de Claude Code:

node --env-file=/Users/you/.config/deepseek-search/.env \
  /Users/you/.local/share/deepseek-search/search-cli.mjs \
  search "Goose custom MCP extension configuration" 3

Recupera la URL elegida con el comando fetch del mismo ayudante. Esta vía sirve si quieres inspeccionar los resultados tú mismo o prefieres no habilitar otra extensión de Goose. Goose no puede invocar ese comando de Shell como una herramienta con nombre, salvo que crees deliberadamente una extensión de comando para ello. El adaptador MCP es la opción más directa para permitir búsquedas iniciadas por el agente.

Si la extensión no arranca, comprueba primero que el comando y las rutas funcionen en una terminal y que el proceso de Goose pueda leer el archivo de entorno. Si las herramientas no aparecen, confirma que la extensión esté habilitada en la sesión actual y que el ID del servidor y el comando se hayan guardado bien. Si la API rechaza la llamada, corrige la clave local y reinicia la extensión. No compartas el archivo de entorno ni copies los encabezados de la solicitud en Goose.

La configuración está lista cuando Goose descubre las dos herramientas en la interfaz elegida y completa una prueba Search → Fetch, autorizada por ti, que incluya la URL de la fuente. Concede acceso solo a las extensiones que necesites: las herramientas de desarrollo de Goose pueden modificar archivos y ejecutar comandos, así que utiliza sus controles de permisos al combinar la investigación web con la ejecución de código.

Autor: Camille Rhodes, arquitecta de más de 300 flujos de trabajo de contenido con IA en Auspia. Escribe sobre flujos prácticos asistidos por IA, automatización y sistemas fiables de publicación.

Más guías de configuración de DeepSeek Search para agentes

Consulta la guía completa de configuración para agentes

Guías de plataformas relacionadas: Conecta DeepSeek Search a Google Antigravity · Usa DeepSeek Search desde Hermes Agent.