researchmap業績登録の選択肢整理と、個人ユーザー向けPlaywright実装

Mon, 04 May 2026 00:00:00 +0900

本記事は生成AIと共同で執筆しています。事実関係は可能な範囲で公式ドキュメント等と照合していますが、誤りが含まれている可能性があります。重要な判断を行う前にご自身でも一次情報をご確認ください。

以前 researchmapの科研費と業績の紐付けをPlaywrightで自動化したという記事を書きました。今回はその続編として、業績そのものの登録を自動化した話をまとめます。

執筆途中でファクトチェックを行い、当初想定していた前提（「公式の書き込み手段はWeb UIに限られる」）が誤っていることが分かりました。この記事ではその過程も含めて、現時点の選択肢を整理した上で、なお自前のPlaywrightスクリプトに利点が残る部分を示します。

researchmap への書き込み手段の現状

19の業績種別すべてに対して、追加・更新・削除が可能なAPIが公開されています。認証はOAuth 2.0（JWT Bearer Flow）で、https://api.researchmap.jp/oauth2/token でアクセストークンを取得します。

利用には申請が必要で、現時点で公開されている運用は次のような形です。

申請書フォーマットは大学等研究機関用が用意されている
WebAPI利用規約第2条第3項(4) では「大学・研究機関等の機関としての申請でなく、個人としての申請と認められる場合（ただし、合理的な理由がある場合を除く。）」は承認しないことがあるとされている
IPアドレスの固定指定が必要、利用は年度単位で継続申請

文言上は「合理的な理由がある場合」の例外条項があり、機関単位での運用が中心であることが想定されています。個人研究者として手元の業績だけを登録したい用途では、後述のCSV/JSONインポートやWeb UI操作が現実的な選択肢になります。

設定 > 「研究者・業績インポート」画面から、ログイン中の研究者本人の業績を一括登録できます。

つまり個人ユーザーでも、JSONLを書ければ事実上の一括書き込みは可能です。

いくつか補足しておきたい点があります：

添付ファイル（PDF等）はインポートの対象外です。API設計書で dataset 配下のフィールドは全業績種別で「更新不可」と明記されています（presentations, published_papers, misc, works など全タイプ）。access_url 等は読み取り専用の出力フィールドです
ZIPアップロードは「JSON/CSVファイルを複数同梱する」用途で定義されており、PDFを同梱する仕様ではありません
インポート画面でのファイルアップロード操作はユーザー側で行う必要があります

1件単位の追加・修正なら最速です。ただし数十件規模になるとつらく、Git等での履歴管理もできません。

公式CSVインポートで対応できる範囲はそちらを使えばよく、私が手元で自動化したかったのは次のような場面でした。

これらに対応するために自作したスクリプトを以下で紹介します。