RemoraFish

Русский · 简体中文

Marco de trabajo centrado en agentes para convertir tus sesiones web autorizadas de ChatGPT, DeepSeek, Kimi, Grok y proveedores externos en APIs compatibles con OpenAI, Mensajes de Anthropic y herramientas MCP. Incluye un runtime sin interfaz, SDK de proveedores, plano de control de cuentas, proveedores de referencia integrados y una interfaz web de referencia.

[!IMPORTANT] Eres el único responsable de tus cuentas y de cada acción realizada con RemoraFish. Úsalo solo con cuentas y perfiles de navegador que poseas o que estés explícitamente autorizado a operar. Eres responsable de la seguridad de las credenciales, del cumplimiento de los términos del proveedor y de la ley aplicable, y de las consecuencias, incluida la restricción, suspensión o pérdida de cuentas. Los autores del proyecto no operan tus cuentas ni garantizan su disponibilidad.

RemoraFish v0.2 es una vista previa del marco de trabajo. Utiliza sesiones web en lugar de claves oficiales de API de desarrollador. Los proveedores pueden cambiar sus protocolos privados o restringir cuentas; no uses una cuenta que no puedas permitirte perder. El repositorio público no contiene credenciales de usuario. Las sesiones de navegador y las cachés de tokens son datos locales de ejecución almacenados fuera del árbol del proyecto por defecto.

Tres formas de usar RemoraFish

La interfaz de usuario incluida es intencionalmente una aplicación de referencia, no el límite del marco de trabajo. Los agentes, clientes de API, frontends personalizados y bifurcaciones de producto utilizan el mismo runtime sin interfaz.

Related MCP server: codex-web-bridge

Inicio rápido

1. Instalar

git clone https://github.com/howdeploy/remorafish.git
cd remorafish
uv sync --extra dev

2. Conectar un agente de codificación

Los agentes de codificación deberían comenzar con AGENTS.md. Si un agente necesita que el contexto del proyecto RemoraFish se entregue de forma persistente entre sesiones, instala y configura choirboy-prompt como un transporte de instrucciones opcional. Reemplaza su lore de demostración incluido con la guía del proyecto RemoraFish; no uses la biografía de demostración sin cambios.

3. Iniciar el plano de control del agente

El flujo de trabajo recomendado es dejar que un agente de codificación local orqueste la configuración de cuentas a través del Admin MCP separado. RemoraFish escanea el navegador del usuario, mantiene las credenciales sin procesar fuera del contexto del agente, devuelve candidatos enmascarados e importa solo las selecciones confirmadas explícitamente:

uv run remorafish admin-mcp \
  --allow-browser-scan \
  --allow-account-mutations

CLI directa e interfaz de referencia

La CLI y la interfaz de referencia siguen disponibles para operación directa:

# Browsers may stay open. Scan live snapshots, validate, and save valid accounts.
uv run remorafish accounts scan --browser all --check --save --yes

# Or choose several browsers and get agent-friendly JSON.
uv run remorafish accounts scan -b brave -b firefox --check --json

uv run remorafish serve

El servidor escucha en http://127.0.0.1:8787 por defecto. Abre Configuración → Cuentas para añadir cualquier número de cuentas de proveedor con un proxy por cuenta. RemoraFish puede abrir un navegador local aislado, enviar un inicio de sesión/contraseña almacenado, esperar MFA o captcha, capturar el token de ejecución resultante y añadir la cuenta al grupo de enrutamiento en vivo sin reiniciar.

curl http://127.0.0.1:8787/v1/responses \
  -H 'Content-Type: application/json' \
  -d '{"model":"deepseek/chat","input":"Hello"}'

# MCP over stdio
uv run remorafish mcp

Los agentes pueden adjuntar archivos locales a través de web_chat. La llamada debe incluir attachments: [{"path":"./report.pdf"}] y confirm_file_access: true explícito; RemoraFish valida la ruta y los límites, sube los bytes a través del flujo web nativo de ChatGPT, DeepSeek, Kimi o Grok del proveedor seleccionado y mantiene las rutas locales fuera de los adaptadores de proveedor. Los clientes HTTP pueden usar partes de imagen/archivo base64 en línea. Consulta HTTP APIs y MCP.

Qué está disponible

La importación del navegador admite Chrome, Chromium, Edge, Brave, Vivaldi, Opera, Firefox y LibreWolf en Linux, macOS y Windows. Los secretos sin procesar se enmascaran en la salida de terminal y JSON; las credenciales guardadas van a ~/.remorafish/accounts.json con modo 0600. Las URL de inicio de sesión/contraseña y de proxy autenticado se mantienen por separado en el cifrado ~/.remorafish/account_vault.json; su clave local y los perfiles de inicio de sesión persistentes también usan permisos solo para el propietario.

ChatGPT se expone como chatgpt/auto; chatgpt/auto-search habilita la función de búsqueda web. Conéctalo desde Configuración → Cuentas → ChatGPT con un token de acceso, una importación de sesión de navegador existente o un inicio de sesión interactivo en el navegador. El protocolo web de ChatGPT incluye una capa anti-bot cambiante, por lo que aún se requiere una prueba de humo de cuenta en vivo después de cambios en el frontend ascendente.

Documentación

• Cómo funciona el sistema

• Marco de proveedores y contrato formal

• Plano de control de cuentas centrado en agentes

• Límite de la interfaz de referencia

• Extracción de credenciales del navegador

• Gestión y enrutamiento de múltiples cuentas

• Interfaces de OpenAI, Anthropic y MCP

• Pruebas de suscripciones web reales

• Contrato de diseño original e investigación de protocolos

Desarrollo

uv run pytest -q
uv run remorafish providers check

La barra de herramientas oficial de Agentation se incluye como una isla React solo para localhost, para que la interfaz web principal pueda permanecer sin marco de trabajo. Reconstruye después de cambios de dependencias:

npm install
npm run build:agentation

Agent Sync usa http://localhost:4747. Registra su servidor MCP con Codex:

codex mcp add agentation -- npx -y agentation-mcp server

Reinicia Codex después de cambiar la configuración de MCP. El código fuente de RemoraFish es MIT. El componente Agentation incluido permanece bajo PolyForm Shield 1.0.0; su aviso requerido se distribuye como remorafish/webui/agentation.LICENSE.txt. Consulta avisos de terceros para las atribuciones de implementación de protocolos y todos los límites de licencia.