使い方ガイド User guide

用途と人の確認Purpose and human review

系統的レビューの PubMed 検索式の下書き、既知文献での検証、他 DB への規則変換に使う道具です。検索式を自分で確かめられる人を想定し、情報専門家・司書の関与を勧めます。AI の案は人が確かめる下書きです。規則による変換も各行を確かめてください。This tool drafts PubMed queries for systematic reviews, checks them against known studies, and converts them for other databases using rules. It is intended for people able to verify queries themselves; involve an information specialist or librarian. AI proposals are drafts for human review. Check every line of rule-based conversions too.

人が確かめないまま最終の検索式として使わないでください。PRESS などの査読の代わりにはなりません。機密のプロトコルを送り先の扱いを確かめずに送らないでください。未確認の版のエクスポートには警告を表示します。費用表示は目安で、実際の請求は提供元で確認してください。Do not use an unchecked draft as your final search strategy or as a replacement for peer review such as PRESS. Do not send confidential protocols without checking provider data handling. Exporting an unreviewed version displays a warning. Costs are estimates; check actual charges with the provider.

初回の AI 送信前の同意、OpenRouter / Anthropic の任意の送信許可、NCBI への email、実行者記録の追加、未確認の版の警告は次回の拡張機能の更新から適用します。Consent before the first AI transmission, optional OpenRouter / Anthropic host permissions, NCBI email, added executor records and warnings for unreviewed versions apply from the next extension update.

Gemini キーだけを保存したときの既定は gemini-3.5-flash-lite です。無料プランを検出すると gemini-2.0-flash へ自動で切り替わります。Google の説明では、無料枠で送った内容と応答は改善に使われ、人が読むことがあります。有料枠では改善に使わず、EEA・スイス・英国では無料でも有料枠の扱いです。With only a Gemini key, the default is gemini-3.5-flash-lite. Detecting a free plan automatically switches to gemini-2.0-flash. According to Google, free-tier content and responses may be used for improvement and read by humans. Paid content is not used for improvement; paid treatment also applies to free services in the EEA, Switzerland and UK.

大規模言語モデルの呼び出しには電力を使います。自動調整の反復上限は必要な分だけにしてください。Calls to large language models use electricity. Set the automatic adjustment iteration limit only as high as needed.

操作解説動画（全 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

操作ツアーと「?」メニュー Guided tours and the “?” menu

アプリのヘッダーにある「ツアー」ボタンから、操作ツアーを始められます。ツアーは画面の実物に枠を付けて、手順を一つずつ案内します。途中でやめても、次に開いたときに続きから再開できます。 Use the “Tours” button in the app header to start a guided tour. A tour puts a frame around the real screen and walks you through one step at a time. If you stop partway, it resumes from where you left off the next time you open the app.

ツアーは次の 4 本です。前提の画面を開ける状態になると、一覧に出ます。 There are four tours. Each one appears in the list once the screen it starts from is available.

• はじめての流れ: プロトコルの入力、ブロックの承認、シード論文の登録までを順に案内します。 動画で見る（2:15） Getting started: A walk through entering the protocol, approving the blocks, and registering seed papers. Watch the video (2:15)
• 検索式の作成と自動調整: 自動調整の設定と開始、履歴、最終レビューの見方を案内します。 動画で見る（2:08） Creating and auto-tuning the formula: How to set up and start auto-tuning, and how to read the history and the final review. Watch the video (2:08)
• シードの拡張: 境界事例の候補を取得し、判定して、更新提案を見るまでを案内します。 動画で見る（1:34） Expanding seeds: How to fetch candidates of borderline cases, judge them, and read the update proposals. Watch the video (1:34)
• 編集と書き出し: 検索式のブロックを編集して保存し、他のデータベース向けに変換するまでを案内します。 動画で見る（1:53） Editing and exporting: How to edit and save the formula blocks, then convert the formula for other databases. Watch the video (1:53)

各画面の見出しの横にある「?」を押すと、その画面のヘルプ、解説動画の該当章、その画面から始められるツアー、ツアーの一覧を選べるメニューが開きます。 The “?” next to each screen’s heading opens a menu with that screen’s help, the matching chapter of the video, a tour you can start from that screen, and the list of all tours.

ツアーとメニューの表示言語（日本語 / English）は、ツアーの一覧の末尾で切り替えられます。 You can switch the display language of the tours and the menu (日本語 / English) at the bottom of the tour list.

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

この章の動画（1:06 から） Video for this chapter (from 1:06)

拡張アイコンを右クリック →「オプション」で設定画面を開き、ご自身の API キーを保存します（BYOK = Bring Your Own Key）。検索式ドラフトの生成には LLM プロバイダの API キーが必須です。既定のモデルは Anthropic の Claude Opus 5.5 で、Anthropic の API キーが必要です。 設定画面の「使用モデル」で Gemini のモデルを選んだ場合は Gemini の API キー、OpenRouter 系のモデルを選んだ場合は OpenRouter の API キーが必要です。 モデルを選ばずに Gemini の API キーだけを保存した場合は、Gemini 3.5 Flash Lite で動きます。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 model is Claude Opus 5.5 from Anthropic, which requires an Anthropic API key. Selecting a Gemini model in “Model” on the settings screen requires a Gemini API key; selecting an OpenRouter model requires an OpenRouter API key. If you save only a Gemini API key without selecting a model, Gemini 3.5 Flash Lite is used. An NCBI API key is optional and eases the rate limit on NCBI E-utilities.

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

この章の動画（2:54 から） Video for this chapter (from 2:54)

拡張アイコンをクリックすると 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

この章の動画（4:10 から） Video for this chapter (from 4:10)

リサーチクエスチョン・フレームワーク種別（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

この章の動画（6:00 から） Video for this chapter (from 6:00)

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

この章の動画（7:24 から） Video for this chapter (from 7:24)

検索式の捕捉率を検証するための基準として、すでに採用が分かっている論文の 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

この章の動画（8:46 から） Video for this chapter (from 8:46)

「検索式を作成・自動調整する」ボタンひとつで、検索式がまだ無ければ AI が承認済みブロックから PubMed 検索式のドラフトを生成し、すでにあれば実測しながら調整します。実測・変更のライブ履歴と、完了後の最終レビューを表示します。すでに検索式があるときは、自動調整カードの直後に「検証のみ再実行」「最初から作り直す」が並び、ブロックごとのヒット数（line_hits）のライブ表示とシード論文の捕捉率・MeSH 検証はこの 2 つの操作でのみ実行されます（自動調整そのものは更新しません）。 A single “Create and auto-adjust the search strategy” action either drafts a PubMed search strategy from the approved blocks (if none exists yet) or measures and tunes the existing one, showing a live history of each measurement and change plus a final review when it finishes. Once a search strategy already exists, “Re-run validation only” and “Start over” appear right below the auto-adjust card 、 only those two actions show each block’s hit count (line_hits) live and run seed-paper capture rate / MeSH validation (auto-adjust itself does not update either).

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

この章の動画（13:02 から） Video for this chapter (from 13:02)

現在の検索式を 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

この章の動画（14:56 から） Video for this chapter (from 14:56)

ブロックはカード単位で並びます。カードにカーソルを合わせて出る鉛筆ボタンから直接インライン編集するか、「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

この章の動画（16:58 から） Video for this chapter (from 16:58)

確定した 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

この章の動画（18:36 から） Video for this chapter (from 18:36)

検索式の開発が完了したことを示す画面です。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

この章の動画（19:17 から） Video for this chapter (from 19:17)

これまでに生成・編集した検索式のバージョン一覧です。各バージョンには、バージョン 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. “Create and auto-adjust the search strategy”) 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. “Create and auto-adjust the search strategy” if no strategy exists yet, or “Start over” right below the auto-adjust card if one already does). Every call, successful or not, is recorded automatically in the LLMApiLog tab.

14. よくある質問 14. FAQ

資金源・利益相反Funding and competing interests

本ツールの開発は JSPS 科研費（JP25K13585）と AMED（課題管理番号 26rea522132h0001「大規模言語モデルによる予防・健康づくり領域のシステマティックレビュー民主化」）の助成を受けています。開発者は AI サービスの提供元（Anthropic、Google、OpenRouter）から報酬を受けていません。Development is supported by JSPS KAKENHI Grant Number JP25K13585 and AMED under Grant Number JP26rea522132. The developer receives no compensation from the AI service providers (Anthropic, Google, OpenRouter).