mcpField
A
aminer-free-academic

aminer-free-academic

github.com/aminerorg生産性6462 回インストール今日更新
リポジトリ

aminer-free-academic について

aminer-free-academicは、AMinerの無料APIを使った研究情報の探索と初期選別向けスキルです。研究者が論文や研究者を探し、名称を正規化して、より詳しい分析が必要か判断できます。

主な機能

  1. 01無料APIでの論文検索と選別
  2. 02研究者の特定
  3. 03機関名と会議・誌名の正規化
  4. 04特許動向の簡易スキャン
  5. 05複数エンティティの探索

活用シーン

  1. 01詳細な確認前の論文選別
  2. 02候補から研究者を特定
  3. 03機関名や会議・誌名の正規化
  4. 04最近の特許動向の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aminerorg/aminer-open-skill --skill aminer-free-academic

インストール後、Claude Code で/aminer-free-academicを入力して読み込まれたか確認します。

詳細

AMiner 無料検索

無料プランを優先するAMinerへのリクエストには、このスキルを使用します。詳しい分析ではなく、候補の発見、初期スクリーニング、エンティティの正規化を目的としています。

対象範囲

このスキルでは、アップグレードされた無料インターフェースのみを使用します。

  • paper_search
  • paper_info
  • person_search
  • organization_search
  • venue_search
  • patent_search
  • patent_info

このスキルで重視する現在の無料プランのフィールド:

  • paper_search:タイトルとキーワードを対象とする検索ボックス query、任意の year / year_from / year_to。doi、venue_name、first_author、n_citation_bucket、year を返します
  • paper_info:abstract_slice、year、venue_id、author_count
  • organization_search:aliases(上位3件)
  • venue_search:aliases(上位3件)、venue_type
  • patent_search:inventor_name(最初の発明者)、app_year、pub_year
  • patent_info:app_year、pub_year
  • person_search:interests、n_citation、所属機関のフィールド

主な目的

無料 API を使って、ユーザーが次の質問に答えられるよう支援します。

  • このエンティティは何ですか?
  • 続けて調べるだけの関連性がありますか?
  • 次に調べる候補はどれですか?
  • この所属機関名または会議・ジャーナル名を正規化できますか?
  • 有料 API にアップグレードするだけの価値はありますか?

研究者の全体像、引用ネットワーク分析、論文の全文に相当する内容の理解、大規模なモニタリング、所属機関の研究成果分析には、このスキルを使用しないでください。

必須ルール

  1. ユーザーが明示的にアップグレードを依頼した場合、または無料の方法では明らかに質問に答えられない場合を除き、無料 API を使用してください。
  2. 無料プランの制限を明確に伝えてください。現時点で回答できる内容と、有料プランへのアップグレードが必要な内容を説明してください。
  3. 有料 API を提案する前に、無料の検索結果を使って候補を絞り込んでください。
  4. エンティティを返す場合、ID が利用可能であればAMinerのURLを付記してください。
    • 論文:https://www.aminer.cn/pub/{paper_id}
    • 研究者:https://www.aminer.cn/profile/{scholar_id}
    • 特許:https://www.aminer.cn/patent/{patent_id}
    • 会議・ジャーナル:https://www.aminer.cn/open/journal/detail/{venue_id}

トークンの確認(必須)

API を呼び出す前に、環境変数 AMINER_API_KEY が存在することを確認してください。トークンを平文で出力しないでください。

if [ -z "${AMINER_API_KEY+x}" ]; then
    echo "AMINER_API_KEY does not exist"
else
    echo "AMINER_API_KEY exists"
fi
  • ${AMINER_API_KEY} が存在する場合:クエリを続行します。
  • ${AMINER_API_KEY} が設定されていない場合:直ちに停止し、AMiner Console でトークンを生成するようユーザーに案内してください。詳しくは、Open Platform Documentation を参照してください。
  • ユーザーが AMINER_API_KEY をインラインで提示した場合(例:「トークンは xxx です」)、現在のセッションでは受け付けますが、セキュリティを高めるため、環境変数として設定することを推奨してください。

呼び出し方法

デフォルトでは、curl を直接呼び出します。このスキルでは Python のラッパーは不要です。

デフォルトのヘッダー:

  • デフォルトの Authorization: ${AMINER_API_KEY}
  • POST リクエストでは Content-Type: application/json;charset=utf-8
  • X-Platform(現在のホスト:claude-code / cursor / codex / openclaw。特定できない場合は unknown)
  • すべての呼び出しに X-Skill-Name: aminer-free-academic および X-Skill-Version(このファイルのフロントマターにある version)

使用する場面

次のような依頼には、このスキルを使用してください。

  • AMiner の無料検索
  • 低コストでの学術情報の発見
  • 論文のスクリーニング
  • 研究者の特定
  • 所属機関名の正規化
  • 会議・ジャーナル名の正規化
  • 特許の動向調査
  • より詳しい分析に進む前の代表的な検索結果

次のようなフレーズがトリガーになります。

  • 「先用免费接口」
  • 「不要走收费接口」
  • 「先帮我筛一下」
  • 「先看看值不值得深挖」
  • 「找几个候选」
  • 「做一个轻量版 skill」

無料のワークフロー

1. 論文の一次選別

ユーザーが論文の関連性を手早く判断したい場合に使用します。

デフォルトのチェーン:

paper_search -> paper_info

paper_search はタイトルのみを検索する機能ではありません。 単一の query 欄でタイトルとキーワードをまとめて検索するため、トピックのフレーズ(retrieval augmented generation)、既知のタイトル、短い質問のいずれでも、追加料金なしで関連する検索結果を取得できます。また、year_from / year_to で期間を絞り込めます。実際の制限は、size が 20 以下、ページ数が最大 10、フィールドごとの条件指定(著者/機関/会場/要旨)ができないこと、並べ替えができないことです。これらのいずれかが必要な場合は、aminer-academic-search の利用が必要です(paper_search_pro、¥0.01)。

返す情報:

  • タイトル
  • 筆頭著者
  • 会場名
  • 年
  • 被引用数の区分
  • 要旨の一部
  • 論文の URL

次のような質問に答えられます:

  • おそらく目的の論文でしょうか?
  • 最近の論文でしょうか?
  • 知名度のある会場で発表された論文でしょうか?
  • 詳しく確認する価値はありますか?
2. 研究者の特定

ユーザーが、どの研究者が該当する人物かを知りたい場合に使用します。

デフォルトのチェーン:

person_search

返す情報:

  • 氏名
  • 所属
  • 研究関心
  • 被引用数
  • 研究者の URL

次のような質問に答えられます:

  • この研究者で合っていますか?
  • この人物の関心を最もよく表す分野は何ですか?
  • 候補となる機関のうち、最も一致するのはどれですか?
3. 機関名の正規化

ユーザーが機関名や略称を入力した場合に使用します。

デフォルトのチェーン:

organization_search

返す情報:

  • 機関 ID
  • 標準名称
  • 別名(上位 3 件)

次のような質問に答えられます:

  • この機関名は認識されていますか?
  • 後続のワークフローでは、どの正式な機関名を使用すべきですか?
4. 会場名の正規化と種別の確認

ユーザーが会議名やジャーナル名を入力した場合に使用します。

デフォルトのチェーン:

venue_search

返す情報:

  • 会場 ID
  • 標準的なバイリンガル名
  • 別名(上位 3 件)
  • 会場の種別
  • 会場の URL

次のような質問に答えられます:

  • これは会議ですか、それともジャーナルですか?
  • 標準的な会場エンティティは何ですか?
5. 特許動向のスキャン

ユーザーがあるトピックに関する特許の概要を手軽に知りたい場合に使用します。

デフォルトのチェーン:

patent_search -> patent_info(ID の基本情報を補足する必要がある場合)

返す情報:

  • 特許タイトル
  • 筆頭発明者
  • 出願年
  • 公開年
  • patent_info を追加する場合は、特許番号と国
  • 特許の URL

次のような質問に答えられます:

  • このトピックは最近活発ですか?
  • 発明者欄の先頭には誰が記載されていますか?
  • さらに詳しく調査する価値のある最近の特許活動はありますか?
6. 無料のエンティティマップ

分析向け API に料金を支払わずに、論文、研究者、会場、機関、特許にわたるトピックの概要を手早く把握したい場合に使用します。

推奨チェーン:

  • 論文:paper_search -> paper_info
  • 研究者:person_search
  • 機関:organization_search
  • 会場:venue_search
  • 特許:patent_search -> patent_info

詳細なレポートではなく、エンティティを横断した短い概要を返します。

無料スキルの使用例

1. 論文の一次選別
curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/search?page=1&size=5&query=Attention%20Is%20All%20You%20Need' \
  -H "Authorization: ${AMINER_API_KEY}" \
  -H 'X-Platform: claude-code' \
  -H 'X-Skill-Name: aminer-free-academic' \
  -H 'X-Skill-Version: 1.3.0'

次に、paper_info で情報を補足します:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/info' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H "Authorization: ${AMINER_API_KEY}" \
  -H 'X-Platform: claude-code' \
  -H 'X-Skill-Name: aminer-free-academic' \
  -H 'X-Skill-Version: 1.3.0' \
  -d '{"ids":["<PAPER_ID>"]}'
2. 研究者の特定
curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/person/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H "Authorization: ${AMINER_API_KEY}" \
  -H 'X-Platform: claude-code' \
  -H 'X-Skill-Name: aminer-free-academic' \
  -H 'X-Skill-Version: 1.3.0' \
  -d '{"name":"Yann LeCun","size":5}'
3. 機関名の正規化
curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H "Authorization: ${AMINER_API_KEY}" \
  -H 'X-Platform: claude-code' \
  -H 'X-Skill-Name: aminer-free-academic' \
  -H 'X-Skill-Version: 1.3.0' \
  -d '{"orgs":["MIT CSAIL"]}'
4. 会場名の正規化と種別の確認
curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/venue/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H "Authorization: ${AMINER_API_KEY}" \
  -H 'X-Platform: claude-code' \
  -H 'X-Skill-Name: aminer-free-academic' \
  -H 'X-Skill-Version: 1.3.0' \
  -d '{"name":"tkde"}'
5. 特許動向のスキャン
curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/patent/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H "Authorization: ${AMINER_API_KEY}" \
  -H 'X-Platform: claude-code' \
  -H 'X-Skill-Name: aminer-free-academic' \
  -H 'X-Skill-Version: 1.3.0' \
  -d '{"query":"quantum computing chip","page":0,"size":10}'

出力形式

次の構成を推奨します:

## Free-tier result

### What we can answer now
- ...

### Top candidates
- ...

### Suggested next step
- Stay free: ...
- Upgrade to paid API only if you need: ...

有料プランへの切り替え基準

ユーザーが次のいずれかを必要とする場合に限り、アップグレードを推奨してください:

  • 要旨全体、または論文のメタデータ全体
  • フィールドごとの論文検索(著者/機関/会場/要旨)、並べ替え、または 1 ページあたり 20 件を超える検索結果
  • 複雑な研究上の質問に対する意味的な理解
  • 引用関係
  • 研究者の全プロフィール、業績、特許、プロジェクト
  • 機関の研究者、論文、特許、または詳細なプロフィール
  • 年別の会場論文リスト
  • IPC/CPC、権利者、説明などの特許詳細情報全体

有料プランへの切り替え先の候補:

  • 論文の詳細分析:paper_search_pro、paper_detail、paper_relation
  • 研究者の詳細分析:person/detail、person/figure、person/paper/relation
  • 機関の詳細分析:organization/detail、organization/person/relation、organization/paper/relation
  • 会場の詳細分析:venue/detail、venue/paper/relation
  • 特許の詳細分析:patent/detail

製品の位置付け

このスキルは、以下を目的として位置付けられています。

  • 最初の成功
  • 無料での検索
  • 候補の絞り込み
  • エンティティの正規化
  • アップグレードの適格性判定

有料スキルの代わりに使用するものではありません。有料スキルへの需要を生み出すことを目的としています。

追加のリファレンス

エンドポイントのパラメーターとフィールドについては、references/api-catalog.md をご覧ください。

コメント