Skip to content

Trace scholarly work across sources

Uni-CLI treats a paper as a set of linked records. A DOI can lead to publisher metadata, an official conference program, an award marker, an OpenReview forum, a PDF, code, and research data. Each returned relationship keeps its own source URL.

Start with one reference

Use a DOI, an exact title, an arXiv identifier, a PMID, or an OpenReview forum URL.

bash
unicli scholar trace 10.1145/3772318.3791239 -D
unicli scholar trace "Attention Is All You Need" -D

scholar trace resolves the bibliographic anchor, searches OpenReview by the resolved title, checks official program context when the venue can be identified, and queries code and dataset sources. Resource rows retain their source attribution, relationship evidence, and candidate status.

An explicit venue and year constrain the bibliographic anchor before relationships are joined. When the anchor already contains an OpenReview forum identifier, the trace reuses it directly for reviews and rebuttals. Title-based resource discovery keeps exact paper-title matches so a similarly named repository cannot enter the trace.

Use a venue override when publisher metadata uses a long proceedings title.

bash
unicli scholar trace 10.1145/3772318.3791239 \
  --venue CHI \
  --year 2026 \
  -D

Resolve the current CCF A directory

The bundled CCF directory follows the formal seventh-edition PDF published in 2026 and its April 9 correction. It contains all 58 A-class conferences across ten fields. Each record retains the PDF page, source URL, official venue link, publisher, former names, and aliases.

bash
unicli ccf conferences
unicli ccf conferences --publisher USENIX
unicli ccf conference ICLR
unicli ccf conference "USENIX ATC"

The former name USENIX ATC resolves to ACM SIGOPS ATC. A lookup for IJCAI returns a structured empty_result because the formal seventh edition no longer lists it as A class.

Search one venue and year

Use scholar venue for proceedings lookup across venue-aware sources. CCF acronyms and former names are resolved before source selection. ACM and IEEE sources are both eligible because DOI registration can change by year or differ from a directory publisher label. Exact venue and year checks remove nearby acronyms and records from another edition. A year inside the positional venue, such as PPoPP 2025, is parsed when --year is absent.

bash
unicli scholar venue FAST --year 2025
unicli scholar venue FOCS --year 2024
unicli scholar venue CAV --year 2024
unicli scholar venue FM --year 2024
unicli scholar search "program synthesis" --venue PLDI --year 2025

DBLP supplies proceedings for CCF venues whose publisher does not expose a suitable paper API, including Springer-backed CAV and FM. When a volume is published in a later calendar year, Uni-CLI reports the conference year in year and retains the deposit year in publication_year.

FAST, NSDI, OSDI, USENIX Security, and the former USENIX ATC series have a first-party USENIX adapter. It reads official technical-session pages and fetches presentation metadata. A PDF is returned only when the official page exposes citation_pdf_url.

bash
unicli usenix venue FAST --year 2025
unicli usenix awards FAST --year 2025
unicli usenix paper "https://www.usenix.org/conference/fast25/presentation/liu-jing"

AAAI main-track papers come from the official AAAI proceedings site. OOPSLA, POPL, PLDI, and ICFP use a PACMPL-aware view that retains volume and issue identity. OOPSLA uses the legacy issue through 2021 and the OOPSLA1 and OOPSLA2 issues from 2022. FSE 2024 and later resolve through PACMSE. SIGMOD 2023 and later resolve the PACMMOD issues listed by the official conference paper index, including issues published in the preceding calendar year. SIGGRAPH resolves through the main-conference issue of ACM Transactions on Graphics. VLDB resolves through Proceedings of the VLDB Endowment. Direct PACMPL, PACMSE, PACMMOD, PVLDB, and VLDB venue queries list the corresponding journal contents without being confused with a conference acronym.

bash
unicli aaai papers --year 2025 --limit 20
unicli scholar venue AAAI --year 2025
unicli pacmpl venue OOPSLA --year 2024
unicli pacmpl venue OOPSLA2 --year 2024
unicli acm venue FSE --year 2024
unicli acm venue SIGMOD --year 2025
unicli acm venue SIGGRAPH --year 2024
unicli scholar venue PACMSE --year 2024
unicli scholar venue VLDB --year 2025
unicli scholar venue "PPoPP 2025"

scholar search extracts a CCF conference and year from the free-form query when possible. It removes proceedings front matter and applies final venue and year checks. A miss can trigger one bounded spelling-recovery pass. Corrected tokens appear in query_corrections, while search_query records the executed query.

bash
unicli scholar search "PPoPP 2025 parallel programming"
unicli scholar search "Budget Recyling Diferential Privcy" \
  --sources ieee,crossref \
  -D

Search and venue fan-out use a 20-second source deadline by default. PDF, resource, and availability collectors run independent sources concurrently. OpenReview requests and retry waits honor caller cancellation and a bounded request deadline. The --timeout option changes the scholar deadline for slow or restricted networks.

bash
unicli scholar venue FAST --year 2025 --timeout 30

Read reviews and rebuttals

The trace output marks an OpenReview match as peer-review-thread. Its next_command calls the review reader with the forum identifier.

bash
unicli scholar reviews abcDEF123 -D

The review reader returns reviews, author responses, decisions, meta-reviews, and public comments as separate chronological rows when the forum exposes them.

Find official awards

SIGCHI conference programs expose award markers beside paper identifiers and ACM DOI links. Official ICLR announcements link each award paper directly to its OpenReview forum, review history, rebuttal, and PDF.

bash
unicli scholar awards CHI --year 2026
unicli sigchi awards CHI --year 2026 --award best-paper
unicli sigchi papers UIST --year 2025 --query "interaction"
unicli scholar awards ICLR --year 2025
unicli iclr awards ICLR --year 2025 --award outstanding-paper
unicli scholar trace "https://openreview.net/forum?id=6Mxhg9PtDE" \
  --venue "ICLR 2025" \
  --year 2025 \
  -D

An award row keeps the official program or announcement URL. A SIGCHI DOI continues through publisher and artifact sources. An ICLR forum identifier continues through OpenReview reviews, author responses, decisions, and PDF access.

Search ACM and IEEE

ACM and IEEE DOI deposits provide keyless publisher-scoped discovery through Crossref. IEEE Xplore adds article numbers, access state, citation counts, conference details, and publisher PDF links when an API key is configured.

bash
unicli acm search "accessible interaction" --year 2026
unicli acm venue "CHI Conference" --year 2026
unicli ieee search "human robot interaction" --year 2025

export IEEE_XPLORE_API_KEY="..."
unicli ieee-xplore search "human robot interaction" --year 2025

unicli ieee search remains available without a key. unicli ieee-xplore search uses the official IEEE Metadata API and returns a structured config_error when its key is absent.

Find datasets and software

DataCite records connect publication DOIs with registered datasets and software. Hugging Face and paper resource adapters add models, Spaces, and project pages. The GitHub scholarly adapter searches repository metadata and README files for DOI or strong title evidence.

bash
unicli datacite search "benchmark dataset" --type Dataset
unicli datacite related 10.1145/3772318.3791239
unicli scholar datasets 10.1145/3772318.3791239 -D
unicli scholar code 10.1145/3772318.3791239 -D

GitHub matches remain candidates until stronger ownership evidence exists. Each row reports relationship, verification, match_type, confidence, and the URL or excerpt that supports the match. is_official_code stays false for a search-derived candidate. scholar trace includes these source-attributed code and dataset relationships in the same graph as publisher, review, award, and PDF records.

bash
unicli github-scholar search \
  --doi 10.1145/3718958.3754348 \
  --title "Raha" \
  --limit 10

Identity and joining rules

The resolver prefers DOI, then arXiv, PMID, OpenReview, and source-local identifiers. Exact normalized title, year, and author overlap provide a bounded fallback when identifiers are missing. Every relationship retains source_adapter, source_url, and retrieved_at.

Award claims require an official conference or society source. Review claims require the review platform thread. PDF and open-access claims require a provider URL that can be inspected independently.

Resource landscape

The shipped source set covers general graphs, major computer science proceedings, preprints, medicine, Chinese literature search, review platforms, open-access lookup, artifacts, and local reference libraries. unicli scholar coverage --sources all -D reports the live command surface.

The next connector groups are part of the scholarly adapter requirements. A connector can ship when it has a stable source identity, explicit authentication behavior, normalized records, actionable failures, and a real lookup test.

Resource familyShipped sourcesConnector requirements
DOI and citation graphsCrossref, DataCite, OpenAlex, Semantic Scholar, DBLPOpenAIRE Graph, CORE, Wikidata scholarly records, Lens, Dimensions, Scopus, Web of Science
Open reviewOpenReviewConference-hosted review systems, journal peer-review histories, review attachments, decision revisions
Computer science proceedingsAAAI, ACM, PACMPL, PACMSE, PACMMOD, SIGCHI, ICLR, IEEE, IEEE Xplore, USENIX, ACL Anthology, CVF, PMLR, NeurIPS, DBLPJMLR, Dagstuhl, LIPIcs, CEUR-WS, Springer proceedings
Preprints and repositoriesarXiv, bioRxiv, medRxivHAL, SSRN, OSF Preprints, ChemRxiv, Research Square, RePEc, EconPapers
Medicine and life sciencesPubMed, PMC links, bioRxiv, medRxivEurope PMC, ClinicalTrials.gov, WHO ICTRP, Cochrane, Crossmark corrections
Journals and booksCrossref publisher metadata, Google Scholar, Baidu Scholar, CNKI, WanfangDOAJ, JSTOR, Project MUSE, Open Library, HathiTrust, Springer Nature, Elsevier, Wiley, Taylor and Francis, Sage, Oxford, Cambridge
Researchers and institutionsAuthor records from OpenAlex, Semantic Scholar, DBLP, OpenReview, PubMedORCID, ROR, Wikidata, Open Funder Registry, national researcher registries
Data and softwareDataCite, Hugging Face resources, verified GitHub candidatesZenodo, Figshare, Dryad, Dataverse, OSF, Software Heritage, GitLab, institutional repositories
Domain indexesPubMed, ACL, CVF, PMLR, NeurIPSNASA ADS, INSPIRE, zbMATH Open, MathSciNet, ERIC, AGRICOLA, GeoRef, PhilPapers
Awards and announcementsSIGCHI and USENIX official programs, ICLR official announcementsACM award pages, IEEE society awards, conference newsrooms, society feeds, correction and retraction notices
Personal librariesZoteroBibTeX libraries, CSL JSON, EndNote XML, RIS, local PDF collections

Paid and institution-licensed sources remain explicit. Their adapters must report the required key, subscription, or browser session and must not hide a restricted result behind an empty response.

Primary API contracts

Adapter work tracks the provider contract or the official public artifact listed here.

ProviderPrimary contract
CrossrefREST API
DataCiteREST API
OpenAlexAPI documentation
Semantic ScholarAcademic Graph API
IEEE XploreAPI portal
OpenReviewAPI documentation
ICLROfficial Blog WordPress API
CCFOfficial recommended directory
USENIXOfficial conference proceedings
AAAIOfficial proceedings
PACMPLCrossref journal records
PACMSECrossref journal records
PACMMODCrossref journal records
ACM TOGCrossref journal records
SIGMODOfficial accepted papers
GitHubREST API
DatamuseWord-finding API
ACL AnthologyAPI documentation
DBLPSearch API documentation
OpenAIREGraph API
COREAPI documentation
Europe PMCREST service
ORCIDPublic API guide
RORREST API
Software HeritageWeb API

Adapter contract

Each scholarly connector should expose the smallest useful subset of these capabilities.

CapabilityReturned evidence
scholar.searchRanked work records with source identity
scholar.getOne bibliographic record by a stable identifier
scholar.pdfA source-backed PDF candidate
scholar.fulltextSource-readable full text
scholar.reviewReviews, rebuttals, decisions, and comments
scholar.venueProceedings or venue contents
scholar.awardsOfficial award records
scholar.contextProgram, announcement, correction, or related context
scholar.citationsWorks that cite the anchor
scholar.referencesWorks cited by the anchor
scholar.codeSoftware and project links
scholar.datasetsData, models, and related research objects

Use unicli search "<academic intent>" before selecting a connector. Use unicli scholar doctor --sources all --live for current source health.

Released under the Apache-2.0 License