Hugging Face Paper Pages

Hugging Face Paper pages (hf.co/papers) は arXiv (arxiv.org) の上に構築されたプラットフォームで、人工知能 (AI) とコンピュータサイエンスの分野における研究論文に特化しています。Hugging Face ユーザーは hf.co/papers/submit で論文を投稿でき、Daily Papers フィード (hf.co/papers) で紹介されます。毎日、ユーザーは論文に投票したり、論文にコメントしたりできます。各論文ページでは、著者は以下のことができます:

• 論文を主張する (authors フィールドで名前をクリックすることで)。これにより論文ページが Hugging Face プロフィールに表示されます。
• モデルカード、データセットカード、または Space の README に HF 論文または arXiv URL を含めることで、関連するモデルチェックポイント、データセット、Space をリンク
• Github リポジトリおよび/またはプロジェクトページ URL をリンク
• HF 組織をリンク。これにより論文ページが Hugging Face 組織ページにも表示されます。

モデルカード、データセットカード、または Space リポジトリの README で HF 論文または arXiv 概要/PDF URL が言及されると、その論文は自動的にインデックスされます。Hugging Face にインデックスされたすべての論文が Daily Papers に投稿されるわけではないことに注意してください。後者はより研究論文を宣伝する方法です。論文は arXiv での公開日から 14 日以内までのみ Daily Papers に投稿できます。

Hugging Face チームは論文ページと相互作用するための使いやすい API を構築しました。論文の内容はマークダウンとして取得でき、著者名、リンクされたモデル/データセット/Space、リンクされた Github リポジトリ、プロジェクトページなどの構造化メタデータを返すことができます。

使用時期

• ユーザーが Hugging Face 論文ページ URL を共有する (例: https://huggingface.co/papers/2602.08025)
• ユーザーが Hugging Face マークダウン論文ページ URL を共有する (例: https://huggingface.co/papers/2602.08025.md)
• ユーザーが arXiv URL を共有する (例: https://arxiv.org/abs/2602.08025 または https://arxiv.org/pdf/2602.08025)
• ユーザーが arXiv ID を言及する (例: 2602.08025)
• AI 研究論文を要約、説明、または分析するよう求められた場合

論文 ID の解析

ユーザーが提供したものから論文 ID (arXiv ID) を解析することをお勧めします:

入力	論文 ID
https://huggingface.co/papers/2602.08025	2602.08025
https://huggingface.co/papers/2602.08025.md	2602.08025
https://arxiv.org/abs/2602.08025	2602.08025
https://arxiv.org/pdf/2602.08025	2602.08025
2602.08025v1	2602.08025v1
2602.08025	2602.08025

これにより、以下で説明する Hub API エンドポイントのいずれにも論文 ID を提供できます。

論文ページをマークダウンとして取得

論文の内容は次のようにマークダウンとして取得できます:

curl -s "https://huggingface.co/papers/{PAPER_ID}.md"

これにより、Hugging Face 論文ページがマークダウンとして返されます。これは https://arxiv.org/html/{PAPER_ID} の論文の HTML バージョンに依存しています。

2 つの例外があります:

• すべての arXiv 論文が HTML バージョンを持つわけではありません。論文の HTML バージョンが存在しない場合、コンテンツは Hugging Face 論文ページの HTML にフォールバックします。
• 404 が返される場合、それは論文がまだ hf.co/papers にインデックスされていないことを意味します。詳細については エラーハンドリング を参照してください。

または、通常の論文ページ URL からマークダウンをリクエストできます:

curl -s -H "Accept: text/markdown" "https://huggingface.co/papers/{PAPER_ID}"

Paper Pages API エンドポイント

すべてのエンドポイントはベース URL https://huggingface.co を使用します。

構造化メタデータを取得

Hugging Face REST API を使用して論文メタデータを JSON として取得:

curl -s "https://huggingface.co/api/papers/{PAPER_ID}"

これは以下を含むことができる構造化メタデータを返します:

• 著者 (名前と Hugging Face ユーザー名、論文を主張した場合)
• メディア URL (Daily Papers に投稿時にアップロード)
• サマリー (概要) と AI 生成サマリー
• プロジェクトページと Github リポジトリ
• 組織およびエンゲージメントメタデータ (アップボート数)

論文にリンクされたモデルを見つけるには:

curl https://huggingface.co/api/models?filter=arxiv:{PAPER_ID}

論文にリンクされたデータセットを見つけるには:

curl https://huggingface.co/api/datasets?filter=arxiv:{PAPER_ID}

論文にリンクされた Space を見つけるには:

curl https://huggingface.co/api/spaces?filter=arxiv:{PAPER_ID}

論文の著作権を主張

Hugging Face ユーザーの論文の著作権を主張:

curl "https://huggingface.co/api/settings/papers/claim" \
  --request POST \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $HF_TOKEN" \
  --data '{
    "paperId": "{PAPER_ID}",
    "claimAuthorId": "{AUTHOR_ENTRY_ID}",
    "targetUserId": "{USER_ID}"
  }'

• エンドポイント: POST /api/settings/papers/claim
• ボディ:
  • paperId (文字列、必須): 主張されている arXiv 論文識別子
  • claimAuthorId (文字列): 主張されている論文の著者エントリ、24 文字の 16 進 ID
  • targetUserId (文字列): 主張を受け取る HF ユーザー、24 文字の 16 進 ID
• レスポンス: 主張された論文 ID を含む論文著作権主張の結果

Daily Papers を取得

Daily Papers フィードを取得:

curl -s -H "Authorization: Bearer $HF_TOKEN" \
  "https://huggingface.co/api/daily_papers?p=0&limit=20&date=2017-07-21&sort=publishedAt"

• エンドポイント: GET /api/daily_papers
• クエリパラメータ:
  • p (整数): ページ番号
  • limit (整数): 結果数、1 から 100 の間
  • date (文字列): RFC 3339 全日付、例えば 2017-07-21
  • week (文字列): ISO 週、例えば 2024-W03
  • month (文字列): 月の値、例えば 2024-01
  • submitter (文字列): 投稿者でフィルタリング
  • sort (enum): publishedAt または trending
• レスポンス: Daily Papers のリスト

論文をリスト表示

公開日でソートされた arXiv 論文をリスト表示:

curl -s -H "Authorization: Bearer $HF_TOKEN" \
  "https://huggingface.co/api/papers?cursor={CURSOR}&limit=20"

• エンドポイント: GET /api/papers
• クエリパラメータ:
  • cursor (文字列): ページネーションカーソル
  • limit (整数): 結果数、1 から 100 の間
• レスポンス: 論文のリスト

論文を検索

論文に対してハイブリッド意味検索とフルテキスト検索を実行:

curl -s -H "Authorization: Bearer $HF_TOKEN" \
  "https://huggingface.co/api/papers/search?q=vision+language&limit=20"

これにより論文タイトル、著者、コンテンツを検索します。

• エンドポイント: GET /api/papers/search
• クエリパラメータ:
  • q (文字列): 検索クエリ、最大長 250
  • limit (整数): 結果数、1 から 120 の間
• レスポンス: マッチングした論文

論文をインデックス

arXiv から ID で論文を挿入。論文がすでにインデックスされている場合、その著者のみが再インデックスできます:

curl "https://huggingface.co/api/papers/index" \
  --request POST \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $HF_TOKEN" \
  --data '{
    "arxivId": "{ARXIV_ID}"
  }'

• エンドポイント: POST /api/papers/index
• ボディ:
  • arxivId (文字列、必須): インデックスする arXiv ID、例えば 2301.00001
• パターン: ^\d{4}\.\d{4,5}$
• レスポンス: 成功時は空の JSON オブジェクト

論文リンクを更新

論文のプロジェクトページ、Github リポジトリ、または投稿組織を更新。リクエスター是応る論文著者、Daily Papers 投稿者、または Papers 管理者である必要があります:

curl "https://huggingface.co/api/papers/{PAPER_OBJECT_ID}/links" \
  --request POST \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $HF_TOKEN" \
  --data '{
    "projectPage": "https://example.com",
    "githubRepo": "https://github.com/org/repo",
    "organizationId": "{ORGANIZATION_ID}"
  }'

• エンドポイント: POST /api/papers/{paperId}/links
• パスパラメータ:
  • paperId (文字列、必須): Hugging Face 論文オブジェクト ID
• ボディ:
  • githubRepo (文字列、nullable): Github リポジトリ URL
  • organizationId (文字列、nullable): 組織 ID、24 文字の 16 進 ID
  • projectPage (文字列、nullable): プロジェクトページ URL
• レスポンス: 成功時は空の JSON オブジェクト

エラーハンドリング

• https://huggingface.co/papers/{PAPER_ID} または md エンドポイントで 404: 論文はまだ Hugging Face 論文ページにインデックスされていません。
• /api/papers/{PAPER_ID} で 404: 論文がまだ Hugging Face 論文ページにインデックスされていない可能性があります。
• 論文 ID が見つからない: 抽出された arXiv ID (バージョンサフィックスを含む) を確認してください

フォールバック

Hugging Face 論文ページがユーザーの質問に十分な詳細を含まない場合:

• https://huggingface.co/papers/{PAPER_ID} の通常の論文ページを確認
• 元のソースの arXiv ページまたは PDF にフォールバック:
  • https://arxiv.org/abs/{PAPER_ID}
  • https://arxiv.org/pdf/{PAPER_ID}

注記

• 公開論文ページには認証は必要ありません。
• 著作権主張、論文インデックス、論文リンク更新などの書き込みエンドポイントには Authorization: Bearer $HF_TOKEN が必要です。
• 信頼性の高い機械可読出力には .md エンドポイントを優先してください。
• ページマークダウンの代わりに構造化 JSON フィールドが必要な場合は /api/papers/{PAPER_ID} を優先してください。