hugging-face-paper-pages

Hugging Face の論文ページ

Hugging Face の論文ページ（hf.co/papers）は、特に人工知能（AI）とコンピューターサイエンス分野の研究論文を対象とした、arXiv（arxiv.org）上に構築されたプラットフォームです。Hugging Face のユーザーは hf.co/papers/submit から論文を投稿でき、Daily Papers フィード（hf.co/papers）に掲載されます。毎日、ユーザーは論文に投票したり、コメントしたりできます。各論文ページでは、著者は次のことができます。

• 論文の所有者として登録する（authors 欄にある自分の名前をクリックします）。これにより、論文ページが自分の Hugging Face プロフィールに表示されます。
• モデルカード、データセットカード、または Space の README に HF 論文または arXiv の URL を含め、関連するモデルのチェックポイント、データセット、Spaces をリンクする
• Github リポジトリやプロジェクトページの URL をリンクする
• HF 組織をリンクする。これにより、論文ページが Hugging Face の組織ページにも表示されます。

誰かがモデルカード、データセットカード、または Space リポジトリの README で HF 論文または arXiv のアブストラクト／PDF の URL に言及すると、その論文は自動的にインデックスに登録されます。Hugging Face でインデックスに登録されたすべての論文が、Daily Papers にも投稿されているわけではない点に注意してください。Daily Papers への投稿は、研究論文を紹介するための手段です。論文は、arXiv での公開日から 14 日以内に限り、Daily Papers に投稿できます。

Hugging Face チームは、論文ページとやり取りするための使いやすい API を構築しました。論文の内容は Markdown として取得でき、著者名、リンクされたモデル／データセット／Spaces、リンクされた Github リポジトリやプロジェクトページなどの構造化メタデータも取得できます。

使用する場面

• ユーザーが Hugging Face の論文ページの URL を共有した場合（例：https://huggingface.co/papers/2602.08025）
• ユーザーが Hugging Face の Markdown 論文ページの 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 を渡せます。

論文ページを Markdown として取得する

論文の内容は、次のように Markdown として取得できます。

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

これにより、Hugging Face の論文ページが Markdown として返されます。これは、https://arxiv.org/html/{PAPER_ID} にある論文の HTML 版を利用します。

例外が 2 つあります。

• すべての arXiv 論文に HTML 版があるわけではありません。論文の HTML 版が存在しない場合、Hugging Face の論文ページの HTML にフォールバックします。
• 404 が返された場合、その論文はまだ hf.co/papers にインデックス登録されていません。詳しくはエラー処理を参照してください。

また、次のように通常の論文ページの URL に Markdown をリクエストすることもできます。

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

論文ページ 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}

論文にリンクされた Spaces を検索するには、次を使用します。

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 を含む、論文著者資格の申請結果

デイリーペーパーを取得する

デイリーペーパーのフィードを取得します。

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（列挙型）：publishedAt または trending
• レスポンス：デイリーペーパーの一覧

論文を一覧表示する

公開日順に並べた 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 リポジトリ、または投稿組織を更新します。リクエストを行うユーザーは、論文の著者、デイリーペーパーの投稿者、または論文管理者である必要があります。

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（文字列、null 可）：GitHub リポジトリの URL
  • organizationId（文字列、null 可）：組織 ID。24 文字の 16 進数 ID
  • projectPage（文字列、null 可）：プロジェクトページの 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 エンドポイントを優先してください。
• ページの Markdown ではなく構造化された JSON フィールドが必要な場合は、/api/papers/{PAPER_ID} を優先してください。