@wentorai/research-plugins 1.0.0

package/skills/literature/metadata/h-index-guide/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: h-index-guide
+description: "Understanding and calculating research impact metrics"
+metadata:
+  openclaw:
+    emoji: "medal"
+    category: "literature"
+    subcategory: "metadata"
+    keywords: ["h-index", "impact factor", "bibliometrics", "academic metrics", "citation statistics"]
+    source: "wentor-research-plugins"
+---
+
+# H-Index and Research Impact Metrics Guide
+
+Understand, calculate, and responsibly interpret bibliometric indicators including h-index, impact factor, and related metrics.
+
+## Core Bibliometric Indicators
+
+### H-Index
+
+The h-index (Hirsch index) is defined as: a researcher has an h-index of h if h of their papers have each been cited at least h times.
+
+**Example**: If a researcher has published 20 papers with citation counts [120, 80, 55, 40, 22, 18, 15, 12, 10, 8, 5, 3, 2, 2, 1, 1, 0, 0, 0, 0], their h-index is 10 (10 papers with at least 10 citations each).
+
+```python
+def calculate_h_index(citation_counts):
+    """Calculate h-index from a list of citation counts."""
+    sorted_counts = sorted(citation_counts, reverse=True)
+    h = 0
+    for i, count in enumerate(sorted_counts):
+        if count >= i + 1:
+            h = i + 1
+        else:
+            break
+    return h
+
+# Example
+citations = [120, 80, 55, 40, 22, 18, 15, 12, 10, 8, 5, 3, 2, 2, 1, 1, 0, 0, 0, 0]
+print(f"h-index: {calculate_h_index(citations)}")  # Output: 10
+```
+
+### Related Author-Level Metrics
+
+| Metric | Definition | Advantage |
+|--------|-----------|-----------|
+| **h-index** | h papers with >= h citations | Simple, robust to outliers |
+| **i10-index** | Number of papers with >= 10 citations | Intuitive threshold (Google Scholar uses this) |
+| **g-index** | Largest g such that top g papers have >= g^2 total citations | Rewards highly cited papers more |
+| **m-quotient** | h-index divided by years since first publication | Normalizes for career length |
+| **hI-norm** | h-index divided by average number of co-authors | Adjusts for team size |
+
+```python
+def calculate_g_index(citation_counts):
+    """Calculate g-index from citation counts."""
+    sorted_counts = sorted(citation_counts, reverse=True)
+    cumulative = 0
+    g = 0
+    for i, count in enumerate(sorted_counts):
+        cumulative += count
+        if cumulative >= (i + 1) ** 2:
+            g = i + 1
+    return g
+
+def calculate_i10_index(citation_counts):
+    """Calculate i10-index."""
+    return sum(1 for c in citation_counts if c >= 10)
+
+print(f"g-index: {calculate_g_index(citations)}")    # Output: 19
+print(f"i10-index: {calculate_i10_index(citations)}") # Output: 10
+```
+
+## Journal-Level Metrics
+
+### Journal Impact Factor (JIF)
+
+Published annually by Clarivate in the Journal Citation Reports (JCR). The 2-year impact factor for year Y is:
+
+```
+JIF(Y) = (Citations in Y to articles published in Y-1 and Y-2)
+         / (Number of citable items published in Y-1 and Y-2)
+```
+
+| Metric | Provider | Window | Notable Features |
+|--------|----------|--------|------------------|
+| Impact Factor | Clarivate (JCR) | 2-year or 5-year | Gold standard, subscription only |
+| CiteScore | Scopus (Elsevier) | 4-year | Free, includes all document types |
+| SJR (Scimago) | Scopus data | 3-year | Weights citations by journal prestige (PageRank-like) |
+| SNIP | Scopus data | 3-year | Normalizes for citation potential of each field |
+| h5-index | Google Scholar | 5-year | Free, h-index applied to a journal |
+
+### Looking Up Journal Metrics
+
+```python
+import requests
+
+# Using the OpenAlex API to get journal/source information
+journal_name = "Nature"
+response = requests.get(
+    "https://api.openalex.org/sources",
+    params={"filter": f"display_name.search:{journal_name}", "per_page": 5}
+)
+results = response.json()["results"]
+for source in results:
+    print(f"Name: {source['display_name']}")
+    print(f"  ISSN: {source.get('issn_l', 'N/A')}")
+    print(f"  Works count: {source.get('works_count', 'N/A')}")
+    print(f"  Cited by count: {source.get('cited_by_count', 'N/A')}")
+    print(f"  h-index: {source.get('summary_stats', {}).get('h_index', 'N/A')}")
+    print(f"  2-year mean citedness: {source.get('summary_stats', {}).get('2yr_mean_citedness', 'N/A')}")
+```
+
+## Calculating Your Own H-Index
+
+### From Google Scholar
+
+Google Scholar profiles automatically display h-index and i10-index. No calculation needed, but coverage is the broadest (includes non-peer-reviewed sources).
+
+### From Semantic Scholar API
+
+```python
+def get_author_h_index(author_name):
+    """Calculate h-index for an author using Semantic Scholar."""
+    # Search for author
+    search_resp = requests.get(
+        "https://api.semanticscholar.org/graph/v1/author/search",
+        params={"query": author_name, "limit": 1}
+    )
+    authors = search_resp.json().get("data", [])
+    if not authors:
+        return None
+
+    author_id = authors[0]["authorId"]
+
+    # Get all papers with citation counts
+    papers_resp = requests.get(
+        f"https://api.semanticscholar.org/graph/v1/author/{author_id}/papers",
+        params={"fields": "citationCount", "limit": 1000}
+    )
+    papers = papers_resp.json().get("data", [])
+    citation_counts = [p.get("citationCount", 0) for p in papers]
+
+    return calculate_h_index(citation_counts)
+```
+
+### From OpenAlex
+
+```python
+# OpenAlex provides h-index directly in author profiles
+author_name = "Geoffrey Hinton"
+response = requests.get(
+    "https://api.openalex.org/authors",
+    params={"filter": f"display_name.search:{author_name}", "per_page": 1}
+)
+author = response.json()["results"][0]
+print(f"h-index: {author['summary_stats']['h_index']}")
+print(f"i10-index: {author['summary_stats']['i10_index']}")
+print(f"2-year mean citedness: {author['summary_stats']['2yr_mean_citedness']}")
+```
+
+## Responsible Use of Metrics
+
+### Known Limitations
+
+1. **Field dependence**: Average citation rates vary dramatically across disciplines. An h-index of 20 is excellent in mathematics but modest in biomedical sciences.
+2. **Career stage bias**: The h-index monotonically increases over time. Always compare within career stage (m-quotient helps).
+3. **Self-citation**: Some databases include self-citations in h-index calculation.
+4. **Database coverage**: Google Scholar, Scopus, and Web of Science yield different h-index values for the same author.
+5. **Gaming**: Metrics can be inflated through citation cartels, salami slicing, and excessive self-citation.
+
+### DORA Declaration
+
+The San Francisco Declaration on Research Assessment (DORA) recommends:
+
+- Do not use journal-based metrics (such as impact factor) as a surrogate measure of individual research quality.
+- Assess research on its own merits rather than on the basis of the journal in which it is published.
+- Use article-level metrics alongside qualitative indicators for assessment.
+
+### Best Practices for Reporting
+
+- Always specify the source database and date when reporting h-index
+- Report multiple metrics rather than relying on a single number
+- Provide field-normalized indicators (FWCI, SNIP) when comparing across disciplines
+- Include qualitative achievements alongside quantitative metrics in CVs and promotion cases

package/skills/literature/metadata/journal-metrics-guide/SKILL.md

@@ -0,0 +1,188 @@
+---
+name: journal-metrics-guide
+description: "Understand journal impact factors, h5-index, CiteScore, and SJR"
+metadata:
+  openclaw:
+    emoji: "bar_chart"
+    category: "literature"
+    subcategory: "metadata"
+    keywords: ["impact factor", "journal metrics", "h5-index", "CiteScore", "SJR", "journal ranking"]
+    source: "wentor-research-plugins"
+---
+
+# Journal Metrics Guide
+
+A skill for understanding, comparing, and responsibly using journal-level metrics including Impact Factor, CiteScore, SJR, SNIP, h5-index, and Eigenfactor. Covers where to find each metric, how they are calculated, their limitations, and how to select appropriate journals for submission.
+
+## Overview of Major Metrics
+
+### Metric Comparison
+
+| Metric | Provider | Formula Basis | Window | Free? |
+|--------|----------|--------------|--------|-------|
+| Impact Factor (JIF) | Clarivate (JCR) | Citations to articles / citable items | 2 years | No |
+| 5-Year IF | Clarivate (JCR) | Same, extended window | 5 years | No |
+| CiteScore | Scopus/Elsevier | Citations / documents | 4 years | Yes |
+| SJR | Scopus/SCImago | Prestige-weighted citations | 3 years | Yes |
+| SNIP | Scopus/CWTS | Citation potential normalized | 3 years | Yes |
+| h5-index | Google Scholar | h-index of articles published in last 5 years | 5 years | Yes |
+| Eigenfactor | Clarivate | Network citation influence | 5 years | Yes |
+
+## How Key Metrics Are Calculated
+
+### Journal Impact Factor
+
+```
+JIF (2024) = Citations in 2024 to articles published in 2022-2023
+             -------------------------------------------------------
+             Number of citable items published in 2022-2023
+
+Example:
+  Journal published 200 articles in 2022-2023
+  Those articles received 1,000 citations in 2024
+  JIF = 1000 / 200 = 5.0
+```
+
+### CiteScore
+
+```
+CiteScore (2024) = Citations in 2021-2024 to items published in 2021-2024
+                   -----------------------------------------------------------
+                   Documents published in 2021-2024
+
+Key difference from JIF:
+  - 4-year window (vs. 2 years)
+  - Includes ALL document types in denominator (not just "citable items")
+  - More transparent calculation
+  - Freely available at scopus.com/sources
+```
+
+### SJR (SCImago Journal Rank)
+
+```python
+def explain_sjr() -> dict:
+    """
+    Explain the SCImago Journal Rank metric.
+    """
+    return {
+        "concept": (
+            "SJR weights citations by the prestige of the citing journal. "
+            "A citation from Nature counts more than a citation from a "
+            "low-prestige journal."
+        ),
+        "algorithm": "Based on Google PageRank applied to citation network",
+        "range": "Typically 0.1 to 20+; most journals 0.2-2.0",
+        "lookup": "scimagojr.com - free access",
+        "quartiles": {
+            "Q1": "Top 25% of journals in the subject category",
+            "Q2": "25th-50th percentile",
+            "Q3": "50th-75th percentile",
+            "Q4": "Bottom 25%"
+        }
+    }
+```
+
+## Finding Journal Metrics
+
+### Free Sources
+
+```
+Google Scholar Metrics:
+  scholar.google.com/citations?view_op=top_venues
+  - h5-index and h5-median for thousands of venues
+  - Filtered by broad discipline or specific subcategory
+  - Updated annually
+
+SCImago Journal Rank:
+  scimagojr.com
+  - SJR, h-index, total documents, total citations
+  - Country and subject area filtering
+  - Free journal comparison tool
+
+Scopus Sources:
+  scopus.com/sources
+  - CiteScore, SJR, SNIP for all Scopus-indexed journals
+  - CiteScore Tracker (real-time estimate)
+  - Free with Scopus account
+```
+
+### Subscription Sources
+
+```
+Journal Citation Reports (JCR):
+  Clarivate Analytics (institutional subscription)
+  - Impact Factor, 5-Year IF, Eigenfactor
+  - Journal quartile rankings by category
+  - Cited/citing journal networks
+
+InCites:
+  Clarivate Analytics
+  - Normalized citation impact at journal and article level
+  - Benchmarking tools
+```
+
+## Responsible Use of Metrics
+
+### Limitations and Pitfalls
+
+```
+1. Field dependence:
+   - Life sciences JIF >> Computer science JIF
+   - Never compare JIF across disciplines
+
+2. Skewed distributions:
+   - A few highly cited papers inflate the average
+   - Median citations per article is more representative
+
+3. Gaming and manipulation:
+   - Excessive self-citation
+   - Citation cartels between journals
+   - Review articles inflating citation counts
+
+4. Not a measure of individual paper quality:
+   - A paper in a high-IF journal may receive zero citations
+   - A paper in a modest journal may become highly influential
+
+5. DORA declaration:
+   - Over 2,500 organizations signed the San Francisco
+     Declaration on Research Assessment (DORA)
+   - Recommends against using JIF as a proxy for
+     individual article quality in hiring, promotion,
+     or funding decisions
+```
+
+### Choosing a Journal for Submission
+
+```python
+def evaluate_journal_fit(metrics: dict, paper_profile: dict) -> dict:
+    """
+    Evaluate journal suitability beyond just impact factor.
+
+    Args:
+        metrics: Journal metrics (JIF, CiteScore, acceptance rate, etc.)
+        paper_profile: Characteristics of your manuscript
+    """
+    criteria = {
+        "scope_match": "Does the journal publish papers on this topic?",
+        "audience": "Will the right readers see this paper here?",
+        "turnaround": "What is the average time from submission to decision?",
+        "open_access": "Does the journal offer OA options? What are the APCs?",
+        "acceptance_rate": "Is the acceptance rate realistic for this paper?",
+        "indexing": "Is the journal indexed in Scopus, WoS, PubMed?",
+        "prestige": "How is this journal perceived in your specific subfield?",
+        "ethics": "Is the journal a member of COPE? Does it follow best practices?"
+    }
+
+    return {
+        "recommendation": "Consider all factors, not just metrics",
+        "criteria": criteria,
+        "warning": (
+            "Avoid predatory journals. Check Beall's list and "
+            "verify the journal is indexed in recognized databases."
+        )
+    }
+```
+
+## Predatory Journal Detection
+
+Watch for these warning signs: unsolicited email invitations to submit, very rapid peer review (days), lack of indexing in Scopus or Web of Science, vague editorial board, no clear ISSN, and APCs that seem unusually low. Use resources like "Think. Check. Submit." (thinkchecksubmit.org) to verify journal legitimacy.

package/skills/literature/metadata/opencitations-api/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: opencitations-api
+description: "Query open citation data and reference networks via OpenCitations"
+metadata:
+  openclaw:
+    emoji: "🔍"
+    category: "literature"
+    subcategory: "metadata"
+    keywords: ["citation statistics", "citation tracking", "citation analysis", "bibliometrics", "citation network"]
+    source: "https://opencitations.net/index/api/v1"
+---
+
+# OpenCitations API Guide
+
+## Overview
+
+OpenCitations is an independent infrastructure organization dedicated to open scholarship and the publication of open bibliographic and citation data. Its main product, the OpenCitations Index of Crossref open DOI-to-DOI citations (COCI), contains over 1.6 billion citation relationships harvested from CrossRef metadata. This makes it the largest fully open citation dataset in the world.
+
+The OpenCitations API allows researchers to programmatically access citation and reference data for any DOI in the index. This is valuable for citation network analysis, bibliometric research, impact assessment, and building literature discovery tools. Unlike proprietary citation databases (Web of Science, Scopus), OpenCitations data is fully open under a CC0 public domain dedication.
+
+The API is free, requires no authentication, and has no published rate limits. It returns data in JSON or CSV format, making it easy to integrate into data analysis pipelines.
+
+## Authentication
+
+No authentication required. The OpenCitations API is fully open and free. No API key, registration, or email is needed. There are no published rate limits, but users should implement reasonable request pacing for large-scale queries. For bulk data access, download the complete COCI dataset from https://opencitations.net/download.
+
+## Core Endpoints
+
+### Citations: Find Papers That Cite a DOI
+
+- **URL**: `GET https://api.opencitations.net/index/v1/citations/{doi}`
+- **Parameters**:
+  | Param | Type | Required | Description |
+  |-------|------|----------|-------------|
+  | doi | string | Yes | The DOI of the cited paper (URL path parameter) |
+  | format | string | No | Response format header: application/json or text/csv |
+- **Example**:
+  ```bash
+  curl "https://api.opencitations.net/index/v1/citations/10.1038/nature12373"
+  ```
+- **Response**: JSON array of citation objects, each containing:
+  - `oci`: OpenCitations Identifier for the citation link
+  - `citing`: DOI of the citing paper
+  - `cited`: DOI of the cited paper (the input DOI)
+  - `creation`: date the citation was first recorded
+  - `timespan`: time between publication of citing and cited papers
+  - `journal_sc`: whether citing and cited are in the same journal (self-citation indicator)
+  - `author_sc`: whether any author appears in both papers (author self-citation indicator)
+
+### References: Find Papers Cited by a DOI
+
+- **URL**: `GET https://api.opencitations.net/index/v1/references/{doi}`
+- **Parameters**:
+  | Param | Type | Required | Description |
+  |-------|------|----------|-------------|
+  | doi | string | Yes | The DOI of the paper whose references to retrieve |
+- **Example**:
+  ```bash
+  curl "https://api.opencitations.net/index/v1/references/10.1038/nature12373"
+  ```
+- **Response**: JSON array of reference objects with the same structure as citations, where `citing` is the input DOI and `cited` are the referenced papers.
+
+### Metadata: Retrieve Paper Metadata
+
+- **URL**: `GET https://api.opencitations.net/index/v1/metadata/{doi}`
+- **Parameters**:
+  | Param | Type | Required | Description |
+  |-------|------|----------|-------------|
+  | doi | string | Yes | The DOI to look up (supports multiple DOIs separated by __) |
+- **Example**:
+  ```bash
+  curl "https://api.opencitations.net/index/v1/metadata/10.1038/nature12373"
+  ```
+- **Response**: JSON array with metadata including `title`, `author`, `year`, `source_title` (journal), `volume`, `issue`, `page`, `doi`, `citation_count`, and `reference`.
+
+### Citation Count: Quick Count Lookup
+
+- **URL**: `GET https://api.opencitations.net/index/v1/citation-count/{doi}`
+- **Parameters**:
+  | Param | Type | Required | Description |
+  |-------|------|----------|-------------|
+  | doi | string | Yes | The DOI to check |
+- **Example**:
+  ```bash
+  curl "https://api.opencitations.net/index/v1/citation-count/10.1038/nature12373"
+  ```
+- **Response**: JSON with `count` field indicating the number of citations in the index.
+
+## Rate Limits
+
+No published rate limits. OpenCitations does not enforce strict API quotas. The service runs on academic infrastructure, so users should be respectful. Best practices include pacing requests to 1-5 per second for sustained queries, caching results, and using the bulk dataset download for large-scale network analyses. The API may return HTTP 503 under heavy load.
+
+## Common Patterns
+
+### Build a Citation Network
+
+Map the citation relationships around a seminal paper:
+
+```bash
+# Get all papers citing the target paper
+curl -s "https://api.opencitations.net/index/v1/citations/10.1145/3292500.3330672" | jq '.[].citing'
+
+# Get all papers referenced by the target paper
+curl -s "https://api.opencitations.net/index/v1/references/10.1145/3292500.3330672" | jq '.[].cited'
+```
+
+### Detect Self-Citations
+
+Filter out self-citations when computing impact metrics:
+
+```bash
+curl -s "https://api.opencitations.net/index/v1/citations/10.1038/nature12373" | jq '[.[] | select(.author_sc == "no")] | length'
+```
+
+### Compare Citation Counts Across Papers
+
+Retrieve citation counts for multiple papers in a batch:
+
+```bash
+# Multiple DOIs separated by double underscore
+curl -s "https://api.opencitations.net/index/v1/metadata/10.1038/nature12373__10.1126/science.aaa8685__10.1016/j.cell.2015.05.002" | jq '.[] | {doi: .doi, title: .title, citations: .citation_count}'
+```
+
+## References
+
+- Official documentation: https://opencitations.net/index/api/v1
+- OpenCitations data model: https://opencitations.net/model
+- COCI dataset download: https://opencitations.net/download

package/skills/literature/metadata/orcid-api/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: orcid-api
+description: "Look up researcher profiles and academic identities via the ORCID registry"
+metadata:
+  openclaw:
+    emoji: "🔍"
+    category: "literature"
+    subcategory: "metadata"
+    keywords: ["researcher ID", "ORCID", "academic identity", "academic metrics"]
+    source: "https://info.orcid.org/documentation/api-tutorial/"
+    requires:
+      env: ["ORCID_ACCESS_TOKEN"]
+---
+
+# ORCID API Guide
+
+## Overview
+
+ORCID (Open Researcher and Contributor ID) is a nonprofit organization that provides unique, persistent digital identifiers to researchers worldwide. With over 18 million registered researchers, ORCID has become the standard for disambiguating author identities across the scholarly ecosystem. Publishers, funders, and institutions use ORCID to reliably connect researchers with their works, grants, and affiliations.
+
+The ORCID Public API provides read access to public data in ORCID records. This includes biographical information, employment history, education, works (publications), funding, and peer review activities. The API is essential for building research information systems, verifying researcher identities, and integrating with institutional repositories.
+
+Authentication is required. The public API uses OAuth 2.0 with a client credentials grant, which provides a bearer token for read-only access to public data. Registration is free and tokens can be obtained programmatically.
+
+## Authentication
+
+The ORCID Public API requires an OAuth 2.0 access token. Register for free API credentials at https://orcid.org/developer-tools and obtain a token:
+
+```bash
+curl -X POST "https://orcid.org/oauth/token" \
+  -H "Accept: application/json" \
+  -d "client_id=YOUR_CLIENT_ID" \
+  -d "client_secret=YOUR_CLIENT_SECRET" \
+  -d "grant_type=client_credentials" \
+  -d "scope=/read-public"
+```
+
+Include the token in all API requests:
+
+```
+Authorization: Bearer YOUR_ACCESS_TOKEN
+```
+
+Tokens are long-lived (typically 20 years) and can be reused across sessions.
+
+## Core Endpoints
+
+### Record: Retrieve Full ORCID Profile
+
+- **URL**: `GET https://pub.orcid.org/v3.0/{orcid-id}/record`
+- **Parameters**:
+  | Param | Type | Required | Description |
+  |-------|------|----------|-------------|
+  | orcid-id | string | Yes | The 16-digit ORCID iD (e.g., 0000-0002-1825-0097) |
+  | Accept | header | No | Response format: application/json, application/xml |
+- **Example**:
+  ```bash
+  curl -H "Authorization: Bearer YOUR_TOKEN" \
+       -H "Accept: application/json" \
+       "https://pub.orcid.org/v3.0/0000-0002-1825-0097/record"
+  ```
+- **Response**: JSON with complete ORCID record including `person` (name, biography, emails, addresses), `activities-summary` (works, funding, employment, education, peer reviews).
+
+### Works: Retrieve Publication List
+
+- **URL**: `GET https://pub.orcid.org/v3.0/{orcid-id}/works`
+- **Parameters**:
+  | Param | Type | Required | Description |
+  |-------|------|----------|-------------|
+  | orcid-id | string | Yes | The ORCID iD |
+- **Example**:
+  ```bash
+  curl -H "Authorization: Bearer YOUR_TOKEN" \
+       -H "Accept: application/json" \
+       "https://pub.orcid.org/v3.0/0000-0002-1825-0097/works"
+  ```
+- **Response**: JSON with `group` array of work summaries, each containing `title`, `external-ids` (DOI, PMID, etc.), `type`, `publication-date`, and `journal-title`.
+
+### Search: Find Researchers
+
+- **URL**: `GET https://pub.orcid.org/v3.0/search`
+- **Parameters**:
+  | Param | Type | Required | Description |
+  |-------|------|----------|-------------|
+  | q | string | Yes | Lucene query syntax (e.g., family-name:Einstein, affiliation-org-name:MIT) |
+  | start | integer | No | Pagination offset (default: 0) |
+  | rows | integer | No | Results per page (default: 100, max: 200) |
+- **Example**:
+  ```bash
+  curl -H "Authorization: Bearer YOUR_TOKEN" \
+       -H "Accept: application/json" \
+       "https://pub.orcid.org/v3.0/search?q=family-name:Hinton+AND+affiliation-org-name:Toronto&rows=10"
+  ```
+- **Response**: JSON with `result` array containing `orcid-identifier` (ORCID iD and URI) for each matching researcher.
+
+## Rate Limits
+
+The public API allows 24 requests per second and 40 burst requests. The member API has higher limits. If limits are exceeded, the API returns HTTP 503 with a `Retry-After` header. For bulk data access, ORCID provides annual data dumps and a Lambda file for incremental updates. Rate limits apply per access token.
+
+## Common Patterns
+
+### Verify Researcher Identity
+
+Confirm that a researcher's ORCID is valid and retrieve their public profile:
+
+```bash
+curl -H "Authorization: Bearer YOUR_TOKEN" \
+     -H "Accept: application/json" \
+     "https://pub.orcid.org/v3.0/0000-0001-5109-3700/person"
+```
+
+### Build a Complete Publication List
+
+Retrieve all works associated with an ORCID profile and extract DOIs:
+
+```bash
+curl -H "Authorization: Bearer YOUR_TOKEN" \
+     -H "Accept: application/json" \
+     "https://pub.orcid.org/v3.0/0000-0002-1825-0097/works" | jq '.group[].work-summary[0] | {title: .title.title.value, doi: (.["external-ids"]["external-id"][] | select(.["external-id-type"] == "doi") | .["external-id-value"])}'
+```
+
+### Find Researchers at an Institution
+
+Search for ORCID profiles affiliated with a specific organization:
+
+```bash
+curl -H "Authorization: Bearer YOUR_TOKEN" \
+     -H "Accept: application/json" \
+     "https://pub.orcid.org/v3.0/search?q=affiliation-org-name:Stanford+AND+current-institution-affiliation-name:Stanford&rows=50"
+```
+
+## References
+
+- Official documentation: https://info.orcid.org/documentation/api-tutorial/
+- API reference: https://pub.orcid.org/v3.0/
+- ORCID integration guide: https://info.orcid.org/documentation/integration-guide/