# pip でインストール pip install "https://www.welltranser.com/downloads/transer-0.4.0-py3-none-linux_x86_64.whl"

from transer import Translator translator = Translator( base_url="https://api.welltranser.com", api_key="発行されたAPIキー", hostname="example.com", # ドメイン管理で登録した値と一致させる contract_langs=["en", "zh-TW", "ko"], # 契約している翻訳先言語 ) # ページ全体を翻訳する translated_html = await translator.translate_page( html=original_html, pathname="/about", source_lang="ja", target_lang="en", )

# proxy.py # ※ サポートページ（module-support-python.html）掲載のコード例そのまま。 # API_KEY・HOSTNAME は、実際にダッシュボードで発行/登録した値に # 書き換えてから起動してください。 import sys import httpx from fastapi import FastAPI, Request from fastapi.responses import HTMLResponse, Response from transer import Translator app = FastAPI() # ▼▼▼ ここを実際にダッシュボードで発行/登録した値に書き換える ▼▼▼ API_KEY = "CHANGE_ME_TO_REAL_API_KEY" HOSTNAME = "CHANGE_ME_TO_REGISTERED_HOSTNAME" # ▲▲▲ ここまで ▲▲▲ BASE_URL = "https://api.welltranser.com" # 書き換え忘れをその場で検知する（気づかずに起動してしまう事故を防ぐ）。 if "CHANGE_ME" in API_KEY or "CHANGE_ME" in HOSTNAME: print("=" * 60, flush=True) print("[起動エラー] API_KEY・HOSTNAME がまだ書き換えられていません。", flush=True) print(" このファイル上部の値を、実際にダッシュボードで発行/登録", flush=True) print(" した値に書き換えてから、もう一度起動してください。", flush=True) print("=" * 60, flush=True) sys.exit(1) translator = Translator(base_url=BASE_URL, api_key=API_KEY, hostname=HOSTNAME) ORIGIN_BASE_URL = "http://127.0.0.1:8080" # 既存サイト（このスクリプトが用意したダミーサイト） # ── SEOオプションについて ── # 「?hl=en」方式（既定）か「/en/about」仮想パス方式かは、このファイル側では # 一切設定しない。ダッシュボードの「オプション設定」→「🔍 SEO対応」トグルの # 状態を、毎リクエスト /contract-langs から取得して従う（環境変数の設定は不要）。 async def fetch_contract_langs_and_seo() -> tuple: """ このドメインの、現在の契約言語一覧と「SEO対応」トグルの状態を 毎リクエスト translate.service へ問い合わせて取得する。 ダッシュボードでの変更が、次のリクエストから即座に反映される （ローカルにハードコード・キャッシュしないため、同期漏れが起きない）。 問い合わせに失敗した場合は、翻訳を行わず原文のまま返す （通信障害時にサイトが丸ごと止まることを防ぐため）。 """ try: async with httpx.AsyncClient(timeout=10) as client: resp = await client.get( f"{BASE_URL}/contract-langs", params={"hostname": HOSTNAME}, headers={"Authorization": f"Bearer {API_KEY}"}, ) if resp.status_code == 200: data = resp.json() return data.get("contract_langs", []), bool(data.get("seo_virtual_path", False)) print(f"[contract-langs] 取得失敗（status={resp.status_code}）: {resp.text[:200]}", flush=True) except Exception as e: print(f"[contract-langs] 取得失敗（通信エラー）: {e}", flush=True) return [], False def resolve_lang_and_origin_path(path: str, request: Request, contract_langs: list, seo_virtual_path: bool) -> tuple: """ 表示する言語と、既存サイト（origin）から取得すべき実際のパスを決定する。 - seo_virtual_path = True の場合（ダッシュボードの「SEO対応」がオン）: URLの先頭セグメントが契約言語と一致するか（例: /en/about）を見る。 一致すればそれを採用し、プレフィックスを除いたパスをoriginへのリクエストに使う。 - seo_virtual_path = False の場合（既定）: ?hl=en のようなクエリパラメータを見る（従来通り）。 """ if seo_virtual_path: segments = path.split("/", 1) first_segment = segments[0] if first_segment in contract_langs: lang = first_segment origin_path = segments[1] if len(segments) > 1 else "" return lang, origin_path return "ja", path lang = request.query_params.get("hl", "ja") return lang, path def build_langbox_snippet(contract_langs: list, seo_virtual_path: bool) -> str: """原文（日本語）ページ用: 言語ボックスのスクリプトタグを組み立てる。""" langs_attr = ",".join(contract_langs) # data-seo="1" を付けると、langbox.js側は言語切り替え時にCookie/クエリではなく # 仮想パス（/en/about等）へ実際にページ遷移するようになる。ダッシュボードの # 「SEO対応」トグルの値をそのまま反映しているだけなので、お客様側で追加の # 設定を意識する必要はない。 seo_attr = ' data-seo="1"' if seo_virtual_path else "" return ( '<script src="https://api.welltranser.com/js/langbox.js?lang=ja" ' f'data-langs="{langs_attr}"{seo_attr} charset="utf-8"></script>' ) # 起動時、設定内容をログにはっきり出す（「どのファイルが・どの設定で」 # 動いているかを journalctl だけで確認できるようにするため）。 print("=" * 60, flush=True) print("[起動設定]", flush=True) print(f" hostname = {HOSTNAME}", flush=True) print(f" origin_base = {ORIGIN_BASE_URL}", flush=True) print(" contract_langs・SEO対応の状態は、毎リクエストごとに translate.service へ問い合わせます", flush=True) print("=" * 60, flush=True) @app.on_event("startup") async def startup_selftest(): """ 起動直後、実際に translate.service へ1回だけ疎通確認を行い、 成功/失敗をログにはっきり出す。 api_key・hostname・契約言語の設定ミスは、ここで即座に判明する。 """ try: contract_langs, _ = await fetch_contract_langs_and_seo() if not contract_langs: print("[起動時セルフテスト] ✗ 失敗: 契約言語一覧を取得できませんでした", flush=True) print(" → api_key・hostname・「ドメイン管理」での登録状況を確認してください", flush=True) return test_html = "<html><head></head><body><p>テスト</p></body></html>" result = await translator.translate_page( test_html, pathname="/__selftest", target_lang=contract_langs[0] ) if "Test" in result or len(result) > len(test_html): print( f"[起動時セルフテスト] ✓ 成功: translate.serviceと正常に通信できています" f"（contract_langs={contract_langs}）", flush=True, ) else: print( f"[起動時セルフテスト] ⚠ 応答はありましたが、翻訳された形跡がありません: {result[:200]}", flush=True, ) except Exception as e: print(f"[起動時セルフテスト] ✗ 失敗: {e}", flush=True) @app.get("/__health") async def health(): """稼働確認用の軽量エンドポイント（curlですぐ確認できるようにするため）""" contract_langs, seo_virtual_path = await fetch_contract_langs_and_seo() return { "status": "ok", "hostname": HOSTNAME, "contract_langs": contract_langs, "origin_base_url": ORIGIN_BASE_URL, "seo_virtual_path": seo_virtual_path, } @app.api_route("/{path:path}", methods=["GET"]) async def proxy(request: Request, path: str): # 契約言語一覧・SEO対応の状態を、ダッシュボードから毎回取得する # （SEO対応がオンの場合、URLの先頭セグメントがこの一覧に実在するかどうかの # 判定にも使う）。 contract_langs, seo_virtual_path = await fetch_contract_langs_and_seo() lang, origin_path = resolve_lang_and_origin_path(path, request, contract_langs, seo_virtual_path) async with httpx.AsyncClient() as client: origin_resp = await client.get(f"{ORIGIN_BASE_URL}/{origin_path}") content_type = origin_resp.headers.get("content-type", "") # 【重要】画像・CSS・JS・フォント等の静的ファイルは、翻訳処理を通さず # そのままバイト列で返す。ここを素通りさせないと、HTMLと同じように # .text で無理やり文字列化してしまい、バイナリデータが壊れてしまう # （画像が文字化けして表示される、CSSが読み込めない等の不具合が起きる）。 if "text/html" not in content_type: return Response( content=origin_resp.content, status_code=origin_resp.status_code, media_type=content_type or None, ) html = origin_resp.text # 【重要】lang の値は訪問者側から渡ってくるもの（?hl= または URL）なので、 # 必ず contract_langs に実在するかどうかで判定すること # （"fr"のような契約外言語をそのまま信用しない）。 if lang in contract_langs: # pathname は「言語プレフィックスを含まない、ページの識別子」を渡す。 # canonical/hreflangタグはサーバー側がこのpathnameを元に自動生成するため。 html = await translator.translate_page(html, pathname="/"+origin_path, target_lang=lang) else: # 原文（日本語）ページ、および契約外の値が指定された場合は、常にこちら。 # target_lang="ja"（原文言語自体）は契約言語一覧に含まれないため、 # translate_page()を呼ぶとサーバー側の契約言語チェックで403エラーになる。 # そのため、原文ページには言語ボックスのスクリプトタグだけを直接挿入する # （WordPressプラグイン版と同じ考え方）。これが無いと、訪問者が最初に # 開いた日本語ページには言語を切り替える手段が一切無くなってしまう。 if "</head>" in html: html = html.replace("</head>", build_langbox_snippet(contract_langs, seo_virtual_path) + "</head>", 1) # ?hl= やURLによって内容が変わるページのため、ブラウザ・ # 中間プロキシに古い言語のページがキャッシュされないよう、明示的に # キャッシュを無効化する。 return HTMLResponse( html, status_code=origin_resp.status_code, headers={"Cache-Control": "no-store, no-cache, must-revalidate"}, )

<script src="https://api.welltranser.com/js/langbox.js?lang=ja" data-langs="en,ko,zh-CN" charset="utf-8"></script> <!-- ダッシュボードで「SEO対応」がオンのドメインの場合は、さらに data-seo="1" が付く -->