acquire-research-papers について
出版元のPDFと生のBibTeXを検証済みのペアとして取得するコマンドラインスキルです。論文の探索やライブラリ管理に対応し、出典の引用データとアクセス制約を維持します。
主な機能
- 01出版元PDFとBibTeXの照合
- 02DOI・URL・タイトルから取得
- 03コーパスと著者の探索
- 04ライブラリの監査と整理
- 05明示的なPDFからMarkdownへの出力
活用シーン
- 01DOIで指定論文を取得
- 02分野やトピックのコーパスを構築・確認
- 03ローカル論文ライブラリの監査と整理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ enoselinsa/ acquire-research-papers --skill acquire-research-papersインストール後、Claude Code で/acquire-research-papersを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
runtime.jsonagents/openai.yamlreferences/author-mode.mdconfiguration.mdcorpus-mode.mdcredentials-and-cache.mdlibrary-mode.mdresearch-mode.mdsource-policies.mdworkflows.mdschemas/author-discovery.schema.jsonauthor-spec.schema.jsoncorpus-spec.schema.jsoninstitution-profile.schema.jsonlibrary-audit.schema.jsonlibrary-plan.schema.jsonpaper-record.schema.jsonresearch-brief.schema.jsonresearch-evidence-review.schema.jsonresearch-review-decision.schema.jsonscripts/arp.py詳細
研究論文を取得する
公式出版社PDFと、出版社の生のBibTeXエクスポートを、検証済みのペアとして提供します。発見メタデータは候補の特定と比較に使用しますが、最終的な引用情報としては使用しません。
インストール済みスキルを実行する
このスキルが実際にインストールされているディレクトリを特定し、ポータブルランチャーを実行します。
python <skill-directory>/scripts/arp.py --help
python <skill-directory>/scripts/arp.py config status
Python 3.11+ と uv が必要です。標準ライブラリのランチャーは、SHA-256を検証してから、runtime.json に記載された固定リリースホイールをスキルの外部にある別のキャッシュへインストールします。開発者用チェックアウトやプロジェクト環境は必要ありません。まだ公開されていないリリースホイールは、リリースURLからブートストラップできません。分離された検証用に、一致するローカルリリースホイールを ARP_LOCAL_WHEEL で指定できます。
最初に arp config status を確認してください。IEEE、MinerU、Elsevier、Semantic Scholar、OpenAlexはオプションで、それぞれ独立しています。現在のタスクに必要な機能のみを設定してください。IEEEへのアクセスには、ユーザーが指定した機関プロファイルを選択してください。保存済みの設定や過去の確認結果は、現在の購読状況やAPIの利用権限を証明するものではありません。チャットでシークレットを求めないでください。公開スキーマのスナップショットは参照用です。arp schema <schema-name.json> は、実行中のリリースに同梱された正式なスキーマを返します。
タスクに応じて使い分ける
| リクエスト | コマンドとリファレンス |
|---|---|
| 機関の設定、プロファイルの切り替え、ログイン、またはアクセスの検証 | arp config setup ieee、arp config ieee list/use/login/doctor を実行し、設定を参照 |
| API/パーサープロバイダーを1つ設定 | arp config setup <provider> を実行し、認証情報とキャッシュを参照 |
| 既知のDOI、出版社URL、正確なタイトル、または明示的に指定された論文リスト | arp fetch を実行し、取得ワークフローを参照 |
| ユーザーが操作するScienceDirectからのダウンロード | arp manual-fetch を実行し、ソースポリシーを参照 |
| 既存ライブラリの整合性、出版物の変更、欠落ペア、または重複 | arp library audit/update を実行し、ライブラリモードを参照 |
| 明示的に指定された書籍の章のインポート、名前変更、整理、または抽出 | arp library import/organize/apply を実行し、ライブラリモードを参照 |
| 著者の出版物(日付範囲やローカルライブラリとの比較を含む) | arp discover author を実行し、著者モードを参照 |
| 会場/トピック/年/件数で指定するコーパス | arp discover corpus --progress → arp review corpus → arp acquire corpus の順に実行し、コーパスモードを参照 |
| 類似研究、関連研究、主張を裏付ける引用、または研究ギャップの根拠 | arp discover research → レビュー → 取得 → 根拠の順に進め、研究モードを参照 |
| 明示的なPDFからMarkdownへのエクスポート | arp export-md を実行し、認証情報とキャッシュを参照 |
添付文書や役割の割り当ては入力アダプターです。関連する要件を汎用的なコーパス/研究/著者の仕様に変換してください。ライブラリタスクまたは著者タスクの実行時には、コーパスと研究の凍結ハッシュを変更しないでください。
レビューと完了
- 元の BibTeX のバイト列、BOM、エンコーディング、改行コードを保持します。解析用のビューのみをデコードします。LLM やメタデータ API を使って引用情報を生成または修復してはいけません。
- DOI、タイトル、年、著者の範囲、掲載先を検証します。特定が曖昧な場合や証拠が不完全な場合は、明示的に報告します。
- コーパスの判断では
evidence-packets.jsonlを確認し、タイトルと要旨に基づく証拠を記録します。取得するのはselection-manifest.jsonに紐付けられた凍結済みのselected-papers.jsonlのみです。キーワードは任意であり、コーパスとの関連性の判断に全文は不要です。 --defer-hostは選択した論文をmanual-download.csvに保持します。凍結済みの選択から入手困難な論文を削除したり、件数を満たすために関連性のしきい値を下げたりしてはいけません。- ライブラリ監査では、ローカル PDF の版、引用の配置、現在のメタデータを区別します。引用が現在のものであっても、PDF が最新版であるとは限りません。明示的な
arp library apply --plan <path>を実行する前にplan.jsonを確認します。update/import/organize は自動適用されません。ロールバックに備えてバックアップを保持します。 - 著者の調査では、情報源の網羅状況、著者の特定に関する曖昧さ、正式版/早期公開版/プレプリントのグループ、号の発行日とオンライン公開日をそれぞれ報告します。書誌情報が完全であると断言してはいけません。
- 通常の取得、手動取得、コーパスのワークフローでは Markdown を生成しません。リサーチでは内部の MinerU キャッシュを使用します。ユーザーが保存先を明示的に指定した場合に限り、Markdown をエクスポートします。
アクセス境界
取得契約を変更する前に情報源のポリシーを、機関に合わせて変更する前に設定を確認します。
認証情報、トークン、Cookie、ブラウザーのストレージ、復号された値を、表示、ログ記録、コミット、送信してはいけません。状態データと成果物は公開リポジトリの外部に保管します。IEEE では、選択した機関専用の分離された可視プロファイルを使用し、認証情報を開示するのは、その機関に正確に設定されたホスト名に限ります。ID プロバイダーへのログイン成功は、IEEE への復帰、ダウンロードの検証、機関の利用資格の証明とは別のものです。
ScienceDirect の論文ページや組織ログインのフローを自動化してはいけません。また、ユーザーが通常使用する Chrome に接続したり、そのプロファイルを読み取ったり、Cookie/セッションデータをエクスポートしたりしてはいけません。認可を受けたユーザーが PDF と未加工の BibTeX を自分でダウンロードし、その後 CLI でローカルの安定したファイルを処理します。出版社や機関の制御を回避したり、ミラー、探索用 BibTeX、生成された引用情報で代用したりしてはいけません。