paper-research

Paper Research — 学術文献検索ツール

コマンドラインから複数の学術データベースを並行検索し、自動で重複を除去して統合し、PDF をダウンロードして BibTeX をエクスポートします。

前提条件

1. CLI バイナリが利用可能であること（~/.local/bin/ または $PATH 内の任意のディレクトリにインストールします）：

   scholar-cli --help
   

2. WebBridge ソース（Google Scholar、CNKI、WoS）を利用するには、kimi-webbridge デーモンが実行中である必要があります：

   ~/.kimi-webbridge/bin/kimi-webbridge status
   

   実行されていない場合は、kimi-webbridge スキルを呼び出してください。

コマンド早見表

# 英文多源并行搜索（默认 7 个源）
scholar-cli search-en --query "关键词" --limit 10

# 指定源搜索
scholar-cli search-en --query "关键词" --sources openalex,semantic,arxiv,dblp

# Google Scholar（需要 WebBridge + 浏览器）
scholar-cli search-google --query "关键词" --limit 10

# 知网搜索（需要 WebBridge + 知网登录）
scholar-cli search-cnki --query "关键词" --limit 20

# Web of Science（需要 WebBridge + 机构登录）
scholar-cli search-wos --query "关键词" --limit 10

# 按 DOI 查论文详情
scholar-cli detail --doi "10.1145/3442188.3445922"

# 搜索并保存到工作区（自动去重）
scholar-cli search-en --query "关键词" --workspace /path/to/workspace

# 导出 BibTeX
scholar-cli export --workspace /path/to/workspace --output refs.bib

# 检查 WoS 登录状态
scholar-cli login-status --platform wos

利用可能なすべてのソース

ソース	ソースコード名	種類	ログインが必要
OpenAlex	openalex	HTTP API	いいえ
Semantic Scholar	semantic	HTTP API	いいえ
CrossRef	crossref	HTTP API	いいえ
arXiv	arxiv	HTTP API	いいえ
PubMed	pubmed	HTTP API	いいえ
DBLP	dblp	HTTP API	いいえ
bioRxiv/medRxiv	biorxiv	HTTP API	いいえ
Google Scholar	—	WebBridge	いいえ（ただし CAPTCHA あり）
CNKI 知網	—	WebBridge	はい
Web of Science	—	WebBridge	はい（機関）

search-en はデフォルトで、最初の 7 つの HTTP API ソースを並行検索します。Google Scholar、CNKI、WoS は個別のコマンドで呼び出す必要があります。

分野 → ソースの対応

分野によって主要文献の分布は大きく異なるため、適切なソースを選ぶことが検索品質を直接左右します。

分野	第一候補のソース	第二候補のソース	説明
コンピューターサイエンス / AI / ML	arxiv, semantic, dblp	openalex	arXiv は CS のプレプリントの主要な公開先であり、S2 は CS の網羅性に優れ、DBLP は CS 文献目録の権威です
生物医学 / 臨床医学	pubmed, biorxiv	crossref, openalex	PubMed は MEDLINE の検索に必須で、bioRxiv/medRxiv は生物医学のプレプリントを網羅しています
物理学 / 数学 / 天文学	arxiv	openalex, crossref	物理学と数学では arXiv が広く利用されています
社会科学 / 経済学	openalex, crossref	semantic	従来型の学術誌が中心で、OpenAlex が最も広く網羅しています
工学 / 材料 / 化学	crossref, openalex	semantic	従来型の学術誌が中心で、CrossRef は DOI メタデータが最も充実しています
中国語文献（全分野）	cnki（知網）	—	中国語の学術誌、学位論文、会議論文を検索するための唯一の信頼できるソースです。ログインが必要です
高被引用度の文献 / 引用分析	search-wos	openalex, semantic	WoS の引用データは最も信頼性が高く、引用分析や影響力の高い論文の検索に適しています
学際的な調査 / レビュー調査	全ソース search-en	search-google	分野が不明な場合は全ソースを並行検索し、重複を除去した後に結果の分布を確認して絞り込みます

使用方針

1. 分野がわかっている場合 → --sources で主要なソースを 2～3 個指定し、ノイズを減らします

   # AI / CS 论文
   scholar-cli search-en --query "large language model reasoning" --sources arxiv,semantic,dblp --limit 15
   
   # 生物医学论文
   scholar-cli search-en --query "CRISPR gene therapy" --sources pubmed,biorxiv,crossref --limit 15
   
   # 工程/材料
   scholar-cli search-en --query "perovskite solar cell" --sources crossref,openalex --limit 15
   

2. 分野がわからない場合 → まず全ソースを検索し、sources の集計を見て有用なソースを判断します

   scholar-cli search-en --query "quantum computing" --limit 5
   # 看返回的 sources 字段，哪个 count 高就追加搜哪个
   

3. 中国語の研究 → search-cnki を使用し、ブラウザーで知網にログイン済みであることを確認します

   scholar-cli search-cnki --query "大语言模型教育应用" --limit 20
   

4. 引用分析 / 影響力の高い文献の絞り込み → WoS を使用します。機関 VPN またはログインが必要です

   scholar-cli search-wos --query "transformer attention" --limit 20
   

5. Google Scholar が必要な場合 → CAPTCHA によってブロックされたら、ブラウザーでユーザーに手動で認証を完了してもらうと、その後しばらく利用できます

   scholar-cli search-google --query "attention mechanism survey"
   

検索キーワードのヒント

• 英語のソース：英語のキーワードを使用します。ブール論理に対応しています（各ソースの API によります）
• 知網：中国語のキーワードを使用します。知網のウェブ検索と同じように動作します
• DBLP：CS の会議論文や学術誌論文のタイトルを特に正確に照合するため、目的が明確な検索に適しています
• bioRxiv：CrossRef の DOI プレフィックスによるフィルタリングを通じて実装されているため、検索品質は CrossRef と同じです
• DOI から詳細情報を取得：検索結果から DOI を取得した場合は、detail コマンドで完全な情報（著者の所属機関、要約、引用数、PDF リンク）を補完できます

ワークスペース管理

ワークスペースでは複数回の検索にわたって論文を蓄積でき、DOI またはタイトルと著者の組み合わせに基づいて自動的に重複を除去します：

# 多次搜索存同一个工作区
scholar-cli search-en --query "term1" --workspace ~/research/my-survey --limit 10
scholar-cli search-en --query "term2" --workspace ~/research/my-survey --limit 10

# 最后统一导出 BibTeX
scholar-cli export --workspace ~/research/my-survey --output ~/research/my-survey/refs.bib

戻り値の papers_added は新たに追加された論文数（既存の論文は重複して追加されません）を、total_stored はワークスペース内の論文総数を表します。

出力形式

すべてのコマンドは JSON を出力します：

• 成功：{"ok": true, "data": {...}}
• 失敗：{"ok": false, "error": {"code": "...", "message": "..."}}

論文のフィールド：title, authors, abstract, year, doi, venue, volume, issue, pages, citations, references, open_access, pdf_url, source, sources, urls, identifiers

よくある質問

問題	原因と対処方法
PubMed が "blocked by NCBI" を返す	NCBI がリクエスト頻度または IP を制限しています。しばらく待ってから再試行するか、API キーを追加してください
DBLP がタイムアウトする	ネットワーク環境によっては dblp.org へのアクセスが不安定ですが、他のソースには影響しません
Google Scholar の CAPTCHA	ブラウザーで一度手動で認証を完了してください
知網が "not_logged_in" を返す	ブラウザーで cnki.net を開いてログインしてください（下記の知網の使用方法を参照）
知網のスライダー CAPTCHA	ログイン時だけでなく、新しいセッション、頻繁なリクエスト、自動化の検出時にも表示されます（下記の知網の使用方法を参照）
WoS が "not_logged_in" を返す	機関 VPN または SSO を通じて Web of Science にログインする必要があります
Semantic Scholar が 0 件を返す	S2 の検索はキーワードに敏感です。より具体的な query に変えて試してください
bioRxiv の年が 0 になる	ごく一部の古い論文では日付メタデータが欠落しています
あるソースがタイムアウトする	他のソースには影響しません。結果の sources にエラー情報が表示されます

知網（CNKI）の使用方法

search-cnki を使用する前に、ブラウザーで以下の準備を完了する必要があります：

1. 知網にログインする — Chrome で https://www.cnki.net を開き、アカウントにログインします
2. スライダー CAPTCHA を一度通過する — https://kns.cnki.net を開いて任意のキーワードを検索します。スライダー CAPTCHA（「セキュリティ検証」ページ）が表示されたら、手動でスライダーを動かして認証を完了します

知網のスライダー CAPTCHA（blockPuzzle タイプ）は、ログイン時だけでなく、以下の状況でも表示されます：

• 新しいセッション / 新しい IP からの初回アクセス
• 短時間に検索を繰り返した場合
• 自動化されたブラウザーの動作が検出された場合

CAPTCHA を自動で突破することはできません。手動で認証を完了する必要があります。一度認証を通過すれば、同じブラウザーセッションでしばらく正常に利用できます。

search-cnki がエラーまたは空の結果を返す場合は、まずユーザーにブラウザーで kns.cnki.net にアクセスしてもらい、CAPTCHA の再認証が必要か確認してください。

依存関係

• 7 つの HTTP API ソース（OpenAlex, Semantic Scholar, CrossRef, arXiv, PubMed, DBLP, bioRxiv）：ログイン不要で、HTTP を直接呼び出します
• Google Scholar：kimi-webbridge の実行 + Chrome の起動が必要です
• CNKI 知網：kimi-webbridge の実行 + Chrome の起動 + 知網へのログイン + スライダー CAPTCHA の手動認証が一度必要です
• Web of Science：kimi-webbridge の実行 + Chrome の起動 + 機関の SSO ログインが必要です