mcpField
A
aminer-free-academic

aminer-free-academic

github.com/aminerorg生産性7863 回インストール2 日前に更新
リポジトリ

aminer-free-academic について

aminer-free-academicは、無料インターフェースで学術情報を調べるAMinerスキルです。論文の初期選別や、研究者・機関・会議・特許の特定と名称整理に使え、無料枠の制限も示します。

主な機能

  1. 01無料の論文検索と情報補完
  2. 02研究者の特定と所属機関の照合
  3. 03機関名・会議名の標準化
  4. 04特許テーマの初期調査
  5. 05無料枠の制限と有料移行条件の提示

活用シーン

  1. 01論文を詳しく読む価値があるかの初期判断
  2. 02氏名と所属機関による研究者の特定
  3. 03機関名や会議名の標準表記への統一
  4. 04特定テーマの特許動向の初期確認

インストール

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

$npx skills add https://github.com/aminerorg/aminer-research-skills --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 が存在することを確認してください。トークンを平文で出力しないでください。

[ -z "${AMINER_API_KEY+x}" ] && echo "AMINER_API_KEY missing" || echo "AMINER_API_KEY exists"
  • ${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

次の情報を返します:

  • 特許のタイトル
  • 筆頭発明者
  • 出願年
  • 公開年
  • 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: ...

有料アップグレードへの切り替え基準

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

  • 要約の全文、正確な引用数(n_citation)、または論文メタデータの全項目
  • 論文のフィールド別検索(著者/機関/掲載媒体/要約)、並べ替え、または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 を参照してください。

コメント