Rosetta

🚀 Rosetta

AIを搭載したExcel翻訳CLIです。書式、数式、データの整合性を維持しながらExcelファイルを翻訳します。

🚀 クイックスタート

Rosettaは、Claude AIを使用してExcelファイル内のすべてのテキストを翻訳します。この際、数式や計算、書式（フォント、色、罫線）、結合セルやレイアウト、チャートや画像、ドロップダウンメニュー、リッチテキスト（セル内の太字、斜体）などが破壊されることはありません。

✨ 主な機能

• 数式や計算を崩さずにExcelファイルを翻訳します。
• 書式（フォント、色、罫線）、結合セルやレイアウト、チャートや画像、ドロップダウンメニュー、リッチテキストを保持します。
• コマンドラインインターフェイスで簡単に操作できます。
• WebアプリケーションとREST APIも提供しています。

📦 インストール

PyPIからインストールします。

pip install rosetta-xl

次に、APIキーを設定します。

# Linux/macOS
export ANTHROPIC_API_KEY=sk-ant-your-key-here

# Windows (Command Prompt)
set ANTHROPIC_API_KEY=sk-ant-your-key-here

# Windows (PowerShell)
$env:ANTHROPIC_API_KEY="sk-ant-your-key-here"

または、作業ディレクトリに.envファイルを作成します。

ANTHROPIC_API_KEY=sk-ant-your-key-here

💻 使用例

基本的な使用法

# フランス語に翻訳
rosetta input.xlsx -t french

# カスタム出力名でスペイン語に翻訳
rosetta input.xlsx -t spanish -o translated.xlsx

# ソース言語を指定（デフォルトで自動検出）
rosetta input.xlsx -s english -t german

# 特定のシートのみを翻訳
rosetta input.xlsx -t french --sheets "Sheet1" --sheets "Data"

# より良い翻訳のためにコンテキストを追加（例：ドメイン固有の用語）
rosetta input.xlsx -t french -c "Medical terminology document"

高度な使用法

価格表を複数の言語に翻訳する：

rosetta prices.xlsx -t french -o prices_fr.xlsx
rosetta prices.xlsx -t german -o prices_de.xlsx
rosetta prices.xlsx -t spanish -o prices_es.xlsx

コンテキスト付きで医療フォームを翻訳する：

rosetta patient_form.xlsx -t french -c "Medical intake form with clinical terminology"

"Questions"シートのみを翻訳する：

rosetta survey.xlsx -t japanese --sheets "Questions"

📚 ドキュメント

オプション

トラブルシューティング

"ANTHROPIC_API_KEY not set"

• キーをエクスポートしていることを確認してください: export ANTHROPIC_API_KEY=sk-ant-...
• または、キーを含む.envファイルを作成してください

"Invalid API key"

• キーがsk-ant-で始まっていることを確認してください
• console.anthropic.comからキー全体をコピーしたことを確認してください

"Rate limit exceeded"

• Anthropicのレート制限に達しました。1分待ってから再度試してください
• または、バッチサイズを減らしてください: rosetta input.xlsx -t french -b 20

仕組み

1. Excelファイルからすべてのテキストセルを抽出します。
2. テキストをClaude AIに送信して翻訳します（バッチ処理）。
3. 翻訳結果を書き戻し、すべての書式を保持します。
4. 翻訳されたファイルを保存します。

元のファイルは決して変更されません。

WebアプリケーションとAPI

Rosettaには、ブラウザベースの翻訳用のWebアプリケーションとREST APIも含まれています。

APIサーバーの起動

# uvでインストール（推奨）
uv sync

# サーバーを起動
uv run uvicorn rosetta.api:app --reload

# またはpipで
pip install -e .
uvicorn rosetta.api:app --reload

APIはデフォルトでhttp://localhost:8000で実行されます。

フロントエンドの起動

cd frontend
npm install
npm run dev

フロントエンドはhttp://localhost:5173で実行され、APIに接続します。

APIエンドポイント

リアルタイム進捗

/translate-streamエンドポイントは、Server-Sent Events (SSE) を使用してリアルタイムで翻訳の進捗をストリーミングします。フロントエンドは、SSEをサポートしないネットワーク（例：企業のプロキシ）では自動的に標準の/translateエンドポイントにフォールバックします。

MCP統合

Rosettaには、Claude DesktopとClaude Webの両方に対応したMCP (Model Context Protocol) サーバーが含まれています。

Claude Desktop（ローカル）用

Claude Desktopの設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "rosetta": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/rosetta", "python", "-m", "rosetta.api.mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}

使用方法: ローカルファイルパスを使用すると最適な結果が得られます。

Translate ~/Downloads/report.xlsx to French

Claude Web（ブラウザ）用

注意: 2026年1月現在、Claude.aiはブラウザでのカスタムMCPサーバーをサポートしていません。

現在の推奨事項: ブラウザベースの翻訳にはWebアプリを使用してください。

詳細な手順については、MCP_USAGE.mdを参照してください。

🔧 技術詳細

• Python 3.11以上が必要です。
• Anthropic APIキーが必要です。

📄 ライセンス

MIT