Awesome-Agent-Skills-for-Empirical-Research scielo-api

Access Latin American and developing world research via SciELO API

install

source · Clone the upstream repo

git clone https://github.com/brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/43-wentorai-research-plugins/skills/literature/search/scielo-api" ~/.claude/skills/brycewang-stanford-awesome-agent-skills-for-empirical-research-scielo-api && rm -rf "$T"

manifest: skills/43-wentorai-research-plugins/skills/literature/search/scielo-api/SKILL.md

source content

SciELO API

Overview

SciELO (Scientific Electronic Library Online) is the primary open access platform for scholarly journals in Latin America, the Caribbean, Spain, Portugal, and South Africa. It indexes 1,800+ peer-reviewed journals and 900K+ articles, many not indexed elsewhere. All content is open access. The API provides article search, journal metadata, and bibliometric indicators. Free, no authentication required.

API Endpoints

ArticleMeta API

Search and retrieve articles:

# Search articles by keyword
curl "https://articlemeta.scielo.org/api/v1/article/?collection=scl&q=machine+learning"

# Get article by PID (SciELO identifier)
curl "https://articlemeta.scielo.org/api/v1/article/?code=S0100-204X2024000100001"

# Filter by collection (country)
curl "https://articlemeta.scielo.org/api/v1/article/?collection=esp&q=climate+change"

# Filter by journal ISSN
curl "https://articlemeta.scielo.org/api/v1/article/?issn=0100-204X&from_date=2024-01-01"

Collection Codes

Code	Country/Region
`scl`	Brazil
`esp`	Spain
`mex`	Mexico
`col`	Colombia
`chl`	Chile
`arg`	Argentina
`cub`	Cuba
`ven`	Venezuela
`prt`	Portugal
`zaf`	South Africa

Journal Metadata

# List journals in a collection
curl "https://articlemeta.scielo.org/api/v1/journal/?collection=scl"

# Get journal by ISSN
curl "https://articlemeta.scielo.org/api/v1/journal/?issn=0100-204X"

# Journal indicators
curl "https://analytics.scielo.org/api/v1/journal/?issn=0100-204X"

SciELO Search API

Full-text search with facets:

# Full-text search
curl "https://search.scielo.org/?q=biodiversity+conservation&format=json&count=20"

# Filter by subject area
curl "https://search.scielo.org/?q=neural+networks&filter[subject_area]=Computer+Science&format=json"

# Filter by year range
curl "https://search.scielo.org/?q=CRISPR&filter[year_cluster]=2023-2026&format=json"

# Filter by language
curl "https://search.scielo.org/?q=epidemiology&filter[la]=en&format=json"

Query Parameters

Parameter	Description	Example
`q`	Free-text query	`q=tropical+ecology`
`collection`	Country code	`collection=scl`
`issn`	Journal ISSN	`issn=0100-204X`
`from_date`	Articles from date	`from_date=2024-01-01`
`until_date`	Articles until date	`until_date=2026-12-31`
`format`	Response format	`json` , `xml`
`count`	Results per page	`count=50`
`offset`	Pagination offset	`offset=20`

Python Usage

import requests

ARTICLE_API = "https://articlemeta.scielo.org/api/v1"
SEARCH_API = "https://search.scielo.org"


def search_scielo(query: str, collection: str = None,
                  count: int = 20) -> list:
    """Search SciELO articles."""
    params = {"q": query, "format": "json", "count": count}
    if collection:
        params["collection"] = collection

    resp = requests.get(f"{SEARCH_API}/", params=params)
    resp.raise_for_status()
    data = resp.json()

    results = []
    for doc in data.get("docs", data.get("results", [])):
        results.append({
            "title": doc.get("title", {}).get("en", doc.get("title", "")),
            "authors": doc.get("authors", []),
            "journal": doc.get("journal_title", ""),
            "year": doc.get("publication_year", ""),
            "doi": doc.get("doi", ""),
            "pid": doc.get("pid", ""),
            "language": doc.get("la", []),
            "url": f"https://scielo.org/article/{doc.get('pid', '')}",
        })
    return results


def get_article(pid: str) -> dict:
    """Get full article metadata by SciELO PID."""
    resp = requests.get(
        f"{ARTICLE_API}/article/",
        params={"code": pid, "format": "json"},
    )
    resp.raise_for_status()
    return resp.json()


def list_journals(collection: str = "scl") -> list:
    """List journals in a SciELO collection."""
    resp = requests.get(
        f"{ARTICLE_API}/journal/",
        params={"collection": collection, "format": "json"},
    )
    resp.raise_for_status()
    return resp.json()


# Example: find Brazilian ecology research
papers = search_scielo("Amazon deforestation biodiversity", collection="scl")
for p in papers:
    print(f"[{p['year']}] {p['title']} — {p['journal']}")

# Example: find Spanish medical research
papers = search_scielo("diabetes treatment", collection="esp")
for p in papers:
    print(f"{p['title']} (DOI: {p['doi']})")