RemoraFish

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

승인된 ChatGPT, DeepSeek, Kimi, Grok 및 외부 제공업체 웹 세션을 OpenAI 호환 API, Anthropic Messages 및 MCP 도구로 전환하는 에이전트 우선 프레임워크입니다. 헤들리스 런타임, 제공업체 SDK, 계정 제어 플레인, 기본 제공 참조 제공업체 및 참조 웹 UI를 제공합니다.

[!IMPORTANT] 귀하는 본인의 계정과 RemoraFish를 사용하여 수행되는 모든 작업에 대해 전적으로 책임이 있습니다. 소유하거나 명시적으로 운영 권한을 부여받은 계정 및 브라우저 프로필에서만 사용하십시오. 자격 증명 보안, 제공업체 약관 및 관련 법률 준수, 그리고 계정 제한·정지·손실을 포함한 결과에 대한 책임은 귀하에게 있습니다. 프로젝트 작성자는 귀하의 계정을 운영하거나 가용성을 보장하지 않습니다.

RemoraFish v0.2는 프레임워크 프리뷰입니다. 공식 개발자 API 키 대신 웹 세션을 사용합니다. 제공업체는 비공개 프로토콜을 변경하거나 계정을 제한할 수 있으므로, 잃어도 감당할 수 없는 계정은 사용하지 마십시오. 공개 저장소에는 사용자 자격 증명이 포함되어 있지 않습니다. 브라우저 세션과 토큰 캐시는 기본적으로 프로젝트 트리 외부에 저장되는 로컬 런타임 데이터입니다.

RemoraFish를 사용하는 세 가지 방법

번들로 제공되는 UI는 의도적으로 참조 애플리케이션이며, 프레임워크의 경계가 아닙니다. 에이전트, API 클라이언트, 사용자 정의 프런트엔드 및 제품 포크는 모두 동일한 헤들리스 런타임을 사용합니다.

Related MCP server: codex-web-bridge

빠른 시작

1. 설치

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

2. 코딩 에이전트 연결

코딩 에이전트는 AGENTS.md부터 시작해야 합니다. 에이전트가 세션 간에 RemoraFish 프로젝트 컨텍스트를 지속적으로 전달받아야 한다면, 선택적 지침 전송 수단으로 choirboy-prompt를 설치하고 구성하십시오. 번들로 제공되는 데모 로어를 RemoraFish 프로젝트 가이드로 교체하고, 데모 바이오그래피를 변경 없이 사용하지 마십시오.

3. 에이전트 제어 플레인 시작

권장 워크플로는 로컬 코딩 에이전트가 별도의 Admin MCP를 통해 계정 설정을 조율하도록 하는 것입니다. RemoraFish 자체는 사용자의 브라우저를 스캔하고, 원시 자격 증명을 에이전트 컨텍스트에서 제외하며, 마스킹된 후보를 반환한 다음, 명시적으로 확인된 선택 항목만 가져옵니다:

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

직접 CLI 및 참조 UI

CLI와 참조 UI는 직접 운영을 위해 계속 제공됩니다:

# 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

서버는 기본적으로 http://127.0.0.1:8787에서 수신 대기합니다. 설정 → 계정을 열어 계정별 프록시와 함께 원하는 수의 제공업체 계정을 추가할 수 있습니다. RemoraFish는 격리된 로컬 브라우저를 열고, 저장된 로그인/비밀번호를 제출하고, MFA 또는 캡차를 기다린 후, 생성된 런타임 토큰을 캡처하고, 재시작 없이 계정을 라이브 라우팅 풀에 추가할 수 있습니다.

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

에이전트는 web_chat을 통해 로컬 파일을 첨부할 수 있습니다. 호출에는 attachments: [{"path":"./report.pdf"}]와 명시적인 confirm_file_access: true가 포함되어야 합니다. RemoraFish는 경로와 제한을 검증하고, 선택한 제공업체의 네이티브 ChatGPT, DeepSeek, Kimi 또는 Grok 웹 흐름을 통해 바이트를 업로드하며, 로컬 경로가 제공업체 어댑터에 전달되지 않도록 합니다. HTTP 클라이언트는 인라인 base64 이미지/파일 파트를 사용할 수 있습니다. HTTP API 및 MCP를 참조하십시오.

사용 가능한 기능

브라우저 가져오기는 Linux, macOS, Windows에서 Chrome, Chromium, Edge, Brave, Vivaldi, Opera, Firefox 및 LibreWolf를 지원합니다. 원시 비밀 값은 터미널 및 JSON 출력에서 마스킹되며, 저장된 자격 증명은 모드 0600으로 ~/.remorafish/accounts.json에 저장됩니다. 로그인/비밀번호와 인증된 프록시 URL은 암호화된 ~/.remorafish/account_vault.json에 별도로 보관되며, 해당 로컬 키와 영구 로그인 프로필에도 소유자 전용 권한이 적용됩니다.

ChatGPT는 chatgpt/auto로 노출되며, chatgpt/auto-search는 웹 검색 기능을 활성화합니다. 설정 → 계정 → ChatGPT에서 액세스 토큰, 기존 브라우저 세션 가져오기 또는 대화형 브라우저 로그인을 통해 연결할 수 있습니다. ChatGPT 웹 프로토콜에는 계속 변화하는 안티봇 계층이 포함되어 있으므로, 업스트림 프런트엔드 변경 후에도 실계정 스모크 테스트가 여전히 필요합니다.

문서

• 시스템 작동 방식

• 제공업체 프레임워크 및 공식 계약

• 에이전트 우선 계정 제어 플레인

• 참조 UI 경계

• 브라우저 자격 증명 추출

• 다중 계정 관리 및 라우팅

• OpenAI, Anthropic 및 MCP 인터페이스

• 실제 웹 구독 테스트

• 원본 설계 계약 및 프로토콜 연구

개발

uv run pytest -q
uv run remorafish providers check

공식 Agentation 툴바는 localhost 전용 React 아일랜드로 번들되어, 메인 웹 UI가 프레임워크에 의존하지 않아도 되도록 합니다. 종속성 변경 후 다시 빌드하십시오:

npm install
npm run build:agentation

Agent Sync는 http://localhost:4747을 사용합니다. 해당 MCP 서버를 Codex에 등록하십시오:

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

MCP 구성을 변경한 후 Codex를 다시 시작하십시오. RemoraFish 소스는 MIT 라이선스입니다. 번들로 제공되는 Agentation 컴포넌트는 계속해서 PolyForm Shield 1.0.0에 따라 라이선스가 부여되며, 필수 고지 사항은 remorafish/webui/agentation.LICENSE.txt로 제공됩니다. 프로토콜 구현 기여자 고지와 모든 라이선스 경계에 대해서는 타사 고지 사항을 참조하십시오.