使い方ガイド User guide

操作解説動画（全 14 章） Video walkthrough (14 chapters)

研究プロトコルの入力から検証済み検索式のエクスポートまでを、実際の画面で通して解説しています（約 21 分）。説明欄のチャプターから各工程へ頭出しできます。ナレーションは日本語、英語字幕（CC）付きです。 A full walkthrough on the real screens, from entering a research protocol to exporting a validated search strategy (about 21 minutes). Use the chapters in the video description to jump to a step. Narration is in Japanese with English subtitles (CC).

YouTube で開く: https://youtu.be/RqUFlmncuIE Watch on YouTube: https://youtu.be/RqUFlmncuIE

1. インストール 1. Installation

Chrome ウェブストアから本拡張を追加します。インストール後、拡張アイコンを右クリックして「オプション」を選ぶと、API キーなどを設定する画面が開きます（設定手順は次の節を参照）。 Add the extension from the Chrome Web Store. After installing, right-click the extension icon and choose “Options” to open the settings screen (see the next section for what to configure there).

2. 初期設定（API キーの登録） 2. Setup: register your API keys

拡張アイコンを右クリック →「オプション」で設定画面を開き、ご自身の API キーを保存します（BYOK = Bring Your Own Key）。検索式ドラフトの生成には LLM プロバイダの API キーが必須です。既定は Gemini なので Gemini API キーが必要ですが、設定画面の「使用モデル」で OpenRouter 系のモデルへ切り替えた場合は OpenRouter の API キーが必要になります。NCBI API キーは任意で、NCBI E-utilities のレート制限を緩和したい場合に設定します。 Right-click the extension icon → “Options” to open the settings screen and save your own API keys (BYOK = Bring Your Own Key). Drafting the search strategy requires an API key for whichever LLM provider is selected. The default is Gemini, so a Gemini API key is needed by default — but if you switch to an OpenRouter model in “Model” on the settings screen, an OpenRouter API key is required instead. An NCBI API key is optional and eases the rate limit on NCBI E-utilities.

3. プロジェクトを作る 3. Create a project

拡張アイコンをクリックすると Popup が開きます。「Google でログイン」のあと、新規プロジェクトを作成するか、最近のプロジェクトから選びます。プロジェクトを作成すると、プロジェクト DB になる Google スプレッドシートがあなたの Google アカウント内に生成されます（1 スプレッドシート = 1 プロジェクト = 1 Drive フォルダ）。作成後、メインビューが新しいタブで開きます。 Clicking the extension icon opens the Popup. After signing in with Google, create a new project or pick one from your recent projects. Creating a project generates a Google Sheet inside your own Google account as the project database (one spreadsheet = one project = one Drive folder). The main view then opens in a new tab.

4. #/protocol 研究プロトコルを入力する 4. #/protocol — Enter the research protocol

リサーチクエスチョン・フレームワーク種別（PICO / PECO / PCC / SPIDER / custom）・組入 / 除外基準を、手入力するか .md または .docx ファイルから取り込みます。保存は常に新しい版として追記され、過去の版は残ります。入力直後には、シード論文（すでに知っている採用予定の論文）があれば PMID を登録するよう案内されます。 Enter your research question, framework type (PICO / PECO / PCC / SPIDER / custom) and eligibility criteria by hand, or import them from a .md or .docx file. Every save is appended as a new version; earlier versions are kept. Right after saving, you are prompted to register any seed papers (studies you already know should be included) by PMID.

5. #/blocks 検索式ブロックを承認する 5. #/blocks — Approve the search blocks

AI がプロトコルから 1〜5 個の検索式ブロック（PICO の各要素に固定されない汎用モデル）を抽出してドラフトします。ブロックごとの用語を確認し、必要であれば編集してから承認します。承認内容は版として追記されます。 AI drafts 1–5 search blocks from the protocol (a generic model, not fixed to PICO’s elements). Review the terms in each block, edit them if needed, and approve. The approved set is appended as a version.

6. #/seeds シード論文を登録する 6. #/seeds — Register seed papers

検索式の捕捉率を検証するための基準として、すでに採用が分かっている論文の PMID を登録します。この工程はスキップして先に進むこともできますが、その場合は捕捉率検証ができません。 Register the PMIDs of studies you already know should be included, so the search strategy’s capture rate can be checked against them. This step can be skipped, but capture-rate validation will then be unavailable.

7. #/draft 検索式ドラフトの生成と検証 7. #/draft — Draft and validate the search strategy

「生成して検証する」ボタンひとつで、AI が承認済みブロックから PubMed 検索式のドラフトを生成し、ブロックごとのヒット数（line_hits）をライブ表示します。生成が完了すると、シード論文の捕捉率検証と MeSH 検証を自動的に実行します。 A single “Generate and validate” action drafts a PubMed search strategy from the approved blocks and shows each block’s hit count (line_hits) live as it runs. Once the draft is complete, seed-paper capture rate validation and a MeSH check run automatically.

8. #/expand 対話的シード拡張（実験的機能） 8. #/expand — Interactive seed expansion (experimental)

現在の検索式を 2 軸（MeSH 一段上＋explode／フリーワードの synonym）で広げた「拡張式」を作り、その外側（拡張式 NOT 現式 = margin）を検索します。その中から AI が境界事例っぽい数件を選び、include / exclude / maybe をワンクリックで判定させます。include した論文は SeedPapers に source=interactive として追加され、自動的に再検証が走ります（margin は現式の外側なので、include が増えると捕捉率が 100% を割ることがあります）。あわせて「どの拡張語が拾えたか」を集計し、ブロックへの追加候補（更新提案）を提示します。採用するかどうかは #/draft で手動判断します。 It builds an “expanded” version of the current query along two axes (one level up in MeSH plus explode, and free-text synonyms), then searches the margin outside it (expanded query NOT current query). AI picks a few borderline-looking candidates from that margin for you to judge with one click: include / exclude / maybe. Included papers are added to SeedPapers with source=interactive and trigger automatic re-validation (since the margin lies outside the current query, adding includes can push the capture rate below 100%). It also tallies which expansion terms were picked up and suggests updates to add to a block. Whether to adopt them is decided manually back in #/draft.

手元にシード論文が無いとき。有効なシード論文が 0 件の状態でこの画面を実行すると、外側ではなく「内側」から初期シードの候補を探します。既定では AI がプロトコルと現在の検索式から 精度優先の specific な絞り込み式（MeSH は Major Topic、フリーワードはタイトル限定）を 1 本設計し、PubMed の関連度（Best Match）順で上位 50 件を取り、その中から組入基準に明確に合致しそうな論文を最大 5 件提示します。設計された式は候補の上に表示されるので確認できます。include した論文が初期シードになり、次回の実行からは外側の探索に切り替わります。specific 式が 0 件や構文エラーのときは現在の検索式の関連度上位に自動で切り替わります。取得ボタンの下のチェックを外すと、現在の検索式そのものの上位から選びます。 When you have no seed papers yet. If you run this screen with zero valid seed papers, it looks inside the query for initial seed candidates instead of outside it. By default the AI designs one precision-first, specific query from your protocol and the current strategy (MeSH as Major Topic, free text restricted to titles), fetches the top 50 results in PubMed's Best Match order, and proposes up to 5 papers that clearly appear to meet the inclusion criteria. The designed query is shown above the candidates so you can check it. Included papers become your initial seeds, and the next run switches to the outside (margin) search. If the specific query returns nothing or fails to parse, it falls back to the Best Match top results of the current query. Uncheck the box below the fetch button to pick from the current query itself instead.

9. #/edit 検索式を編集する 9. #/edit — Edit the search strategy

ブロックはカード単位で並びます。カードにカーソルを合わせて出る鉛筆ボタンから直接インライン編集するか、「AI に改善させる」で改善したい内容を指示文として入力します。指示を送る際、リサーチクエスチョン・ブロック定義・シード論文・直近の検証結果（捕捉率・取りこぼし）が文脈として AI に開示されます。AI の提案は diff で表示され、accept / reject を選べます。 Blocks are laid out as cards. Hover a card to reveal a pencil button for direct inline editing, or use “Improve with AI” to describe what you want changed. When you submit an instruction, the research question, block definitions, seed papers and the most recent validation result (capture rate, misses) are disclosed to the AI as context. Its proposal is shown as a diff, and you accept or reject it.

10. #/export 各データベースへ変換・エクスポートする 10. #/export — Convert and export for each database

確定した PubMed 検索式を、CENTRAL / Embase(Dialog) / ClinicalTrials.gov / ICTRP 向けに変換します。変換結果は .md としてダウンロードでき、検索式を直接 PubMed で開くリンクも表示されます。各データベースの検索ページへ実際に案内し、nbib 形式でのダウンロード手順を示すのは、次の #/done 画面です（ダウンロード自体の自動化はしません）。 Convert the finalized PubMed search strategy for CENTRAL, Embase (Dialog), ClinicalTrials.gov and ICTRP. The converted output can be downloaded as .md, and a link to open the query directly in PubMed is shown too. The actual links to each database’s search page, and the step-by-step guidance for downloading in nbib format, are on the next screen, #/done (the download itself is not automated).

11. #/done 完了画面 11. #/done — Finish screen

検索式の開発が完了したことを示す画面です。PubMed を検索式つきで直接開くリンクに加え、Cochrane CENTRAL / Embase(Dialog) / ClinicalTrials.gov / ICTRP それぞれの検索ページへのリンクと、貼り付け先（Advanced search の場所など）を database ごとに一言で案内します。あわせて「PubMed は Send to → Citation manager → PubMed format (NBIB)、ClinicalTrials.gov / ICTRP は各画面の XML / CSV から書き出せます」という案内文を表示します。実際のダウンロード操作は各データベースのサイト上でご自身で行ってください（自動化はしません）。 This screen marks that the search strategy is finished. Besides a link that opens PubMed directly with the query, it links to the search page of Cochrane CENTRAL, Embase (Dialog), ClinicalTrials.gov and ICTRP, each with a one-line note on where to paste the converted query (e.g. which advanced-search field). It also shows guidance text: “PubMed: Send to → Citation manager → PubMed format (NBIB); ClinicalTrials.gov / ICTRP: export from each site’s XML / CSV.” The actual download happens on each database’s own site — it is not automated here.

12. #/history バージョン履歴 12. #/history — Version history

これまでに生成・編集した検索式のバージョン一覧です。各バージョンには、バージョン ID・作成者 （ai_draft = AI ドラフト / user_edit = 手動編集 / auto_optimize = 自動最適化のいずれかの値が画面にそのまま表示されます）・作成日時・メモ（あれば）・検索式のプレビューが並びます。「このバージョンを読み込む」を押すと、そのバージョンを #/draft の状態として読み込みます。 A list of every version of the search strategy you have drafted or edited. Each entry shows its version ID, creator (the raw value is shown as-is: ai_draft = AI draft, user_edit = manual edit, or auto_optimize = auto-optimize), creation time, note (if any), and a preview of the search strategy. Clicking “Load this version” loads it back into #/draft.

13. トラブルシューティング 13. Troubleshooting

Google API のエラーが表示される（認証切れ・書き込み権限不足など） A Google API error is shown (expired auth, missing write permission, etc.)

専用のモーダルやボタンは無く、その画面のエラー欄にそのままエラーメッセージが表示されます（例: 「Google API failed: HTTP 401 …」「… HTTP 403 …」）。頻発する・解消しない場合は、Popup の 「ログアウト」ボタンでキャッシュされた認証情報を破棄してから再度「Google でログイン」してください。書き込み権限の不足（403）が疑われる場合は、プロジェクトの Google スプレッドシート自体を開き、共有設定で編集権限があるか確認してください。 There is no dedicated modal or button — the error message is shown as plain text in that screen’s error area (e.g. “Google API failed: HTTP 401 …” or “… HTTP 403 …”). If this happens repeatedly or won’t clear, use the “Log out” button in the Popup to discard the cached credentials, then sign in with Google again. If you suspect a missing write permission (403), open the project’s Google Sheet itself and check its sharing settings for edit access.

共有されたスプレッドシートが開けない（次回更新から） A shared spreadsheet cannot be opened (from the next update)

本拡張は Google ドライブ全体ではなく「利用者が作成に関与したファイル」だけにアクセスします。そのため、他の人が作って共有したスプレッドシートは、そのファイルを 1 回だけ明示的に選ぶまで開けません。Popup の「スプレッドシート ID で開く」で共有シートを指定すると、「Google で許可する」ボタンが表示されるので、押して開いた画面（Google 公式のファイル選択画面）で対象のシートを選んでください。 以後、そのシートは選び直さずに開けます。ファイル選択画面に目的のシートが出てこない場合は、まず Google ドライブ側でそのシートが自分のアカウントに共有されているかを確認し、「共有アイテム」タブも見てください。許可しても開けないときは、シートが削除されている・ID が間違っている可能性もあります。 The extension accesses only “files you were involved in creating”, not your whole Google Drive. A spreadsheet created and shared by someone else therefore cannot be opened until you explicitly select that file once. Enter the shared spreadsheet’s ID under “Open by spreadsheet ID” in the Popup and a “Grant access with Google” button appears; press it and select the spreadsheet in the Google file picker that opens. From then on it opens without asking again. If the spreadsheet does not appear in the picker, first check in Google Drive that it is shared with your account, and look at the “Shared with me” tab. If it still cannot be opened after granting access, the spreadsheet may have been deleted or the ID may be wrong.

NCBI のレート制限に当たる Hitting the NCBI rate limit

専用のバナーは表示されません。NCBI E-utilities の呼び出しはレート制限（429 等）を検知すると内部で自動的に指数バックオフ再試行するため、進行中の操作（例: 「生成して検証する」）がいつもより時間がかかって見えるだけです。頻発する場合は、Options 画面で NCBI API キー（任意）を設定すると割り当てが 3 req/s → 10 req/s に上がり緩和されます。 There is no dedicated banner. Calls to NCBI E-utilities automatically retry with exponential backoff internally when they hit a rate limit (e.g. 429), so the in-progress action (e.g. “Generate and validate”) just appears to take longer than usual. If this happens often, set the optional NCBI API key in Options — it raises the allowance from 3 req/s to 10 req/s.

Gemini（LLM）API がエラーになる The LLM (Gemini) API returns an error

専用のバッジや「再試行」ボタンは無く、その画面のエラー欄に「生成に失敗しました: 〈エラー内容〉」のようにそのまま表示されます。API キーが正しいか、利用枠を超えていないかを Options 画面で確認したうえで、同じ操作ボタン（例: 「生成して検証する」/「再生成して再検証する」）をもう一度押してください。エラーは成功・失敗を問わず LLMApiLog タブに自動的に記録されます。 There is no dedicated badge or “Retry” button — the screen’s error area shows the message as-is, e.g. “Generation failed: 〈error detail〉”. Check in Options that your API key is correct and that you have not exceeded your quota, then press the same action button again (e.g. “Generate and validate” / “Regenerate and revalidate”). Every call — successful or not — is recorded automatically in the LLMApiLog tab.

14. よくある質問 14. FAQ