Semantic Scholar

Semantic Scholar Skill

Source: NousResearch/hermes-agent (MIT) — Semantic Scholar API pattern adapted for YAMTAM

Tier: TIER 3 — PRODUCTIVITY

Tra cứu citation, impact, và references của paper khoa học qua Semantic Scholar API. Rate limit: 1 request/giây không cần API key. Có JSON response, dễ parse hơn arXiv.

Khi nào dùng

• Kiểm tra citation count của một paper cụ thể
• Tìm tất cả paper cite một công trình nào đó ("who builds on this?")
• Xem references list của một paper
• Tra thông tin tác giả: h-index, top papers, collaboration network
• So sánh impact của nhiều paper

Do NOT use for: tìm paper theo keyword (dùng arxiv-research), full-text (dùng arxiv PDF URL trực tiếp).

API Reference

Base URL: https://api.semanticscholar.org/graph/v1/
Auth:     Không cần key cho rate ≤ 1 req/s
Headers:  User-Agent: yamtam-research/1.0 (optional nhưng tốt)
Limit:    1 req/s — sleep 1 between calls

Pipeline

Step 1 — Lookup paper by arXiv ID hoặc DOI

# Từ arXiv ID (e.g., 2303.08774)
ARXIV_ID="2303.08774"
FIELDS="title,authors,year,citationCount,referenceCount,citations,references,abstract"

curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:${ARXIV_ID}?fields=${FIELDS}" \
  -H "User-Agent: yamtam-research/1.0" \
  -o /tmp/s2_paper.json
sleep 1

# Từ DOI
DOI="10.48550/arXiv.2303.08774"
curl -s "https://api.semanticscholar.org/graph/v1/paper/DOI:${DOI}?fields=${FIELDS}" \
  -o /tmp/s2_paper.json
sleep 1

# Search by title keyword (khi không có ID)
QUERY="attention+is+all+you+need"
curl -s "https://api.semanticscholar.org/graph/v1/paper/search?query=${QUERY}&fields=title,year,citationCount,authors&limit=5" \
  -o /tmp/s2_search.json
sleep 1

Step 2 — Parse paper info

import json

with open('/tmp/s2_paper.json') as f:
    p = json.load(f)

print(f"Title: {p['title']}")
print(f"Year: {p.get('year', 'N/A')}")
print(f"Citations: {p.get('citationCount', 0)}")
print(f"References: {p.get('referenceCount', 0)}")
print(f"Authors: {', '.join(a['name'] for a in p.get('authors', [])[:5])}")
print(f"Abstract: {(p.get('abstract') or '')[:300]}...")

Step 3 — Get citations (who cited this paper)

# Từ response đã fetch ở Step 1
citations = p.get('citations', [])
print(f"\nTop citations ({len(citations)} total):")
for c in citations[:10]:
    print(f"  [{c.get('year', '?')}] {c['title']} — {c.get('citationCount', 0)} cites")

# Nếu cần paginate citations riêng
PAPER_ID="<semanticscholar_paper_id>"
curl -s "https://api.semanticscholar.org/graph/v1/paper/${PAPER_ID}/citations?fields=title,year,authors,citationCount&limit=20" \
  -o /tmp/s2_citations.json
sleep 1

Step 4 — Author lookup

# Tìm author ID từ paper
AUTHOR_ID=$(python3 -c "import json; d=json.load(open('/tmp/s2_paper.json')); print(d['authors'][0]['authorId'])")

# Lấy profile tác giả
curl -s "https://api.semanticscholar.org/graph/v1/author/${AUTHOR_ID}?fields=name,hIndex,citationCount,paperCount,papers" \
  -o /tmp/s2_author.json
sleep 1

python3 -c "
import json
a = json.load(open('/tmp/s2_author.json'))
print(f'Name: {a[\"name\"]}')
print(f'h-index: {a.get(\"hIndex\", \"N/A\")}')
print(f'Total citations: {a.get(\"citationCount\", 0)}')
print(f'Papers: {a.get(\"paperCount\", 0)}')
"

Output format chuẩn

## Paper: [Title]

- **arXiv ID:** 2303.08774
- **Year:** 2023
- **Citations:** 1,247
- **Authors:** Author A, Author B, Author C
- **Abstract:** ...

### Top Citing Papers
| Year | Title | Citations |
|------|-------|-----------|
| 2024 | ...   | 89        |

### Key References
- [2017] Attention Is All You Need — 89,000 citations

Anti-Fake-Pass Checks

❌ FAIL nếu không sleep 1s giữa các request (rate limit violation)
❌ FAIL nếu citationCount không hiển thị cụ thể (không verify được)
❌ FAIL nếu dùng paper ID từ arXiv mà không prefix "arXiv:" trong URL
❌ FAIL nếu author lookup không có authorId (authorId = required field)
✅ PASS khi: citation count + paper URL + author name đều verify được trên semanticscholar.org

See also

• arxiv-research — tìm paper theo keyword/topic
• research-analyst — tổng hợp findings từ nhiều paper