@wentorai/research-plugins 1.0.0 → 1.2.0

package/skills/literature/search/scielo-api/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: scielo-api
+description: "Access Latin American and developing world research via SciELO API"
+metadata:
+  openclaw:
+    emoji: "🌎"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["SciELO", "Latin America", "open access journals", "developing countries", "Brazilian research", "Spanish research"]
+    source: "https://wiki.scielo.org/"
+---
+
+# 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:
+
+```bash
+# 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
+
+```bash
+# 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:
+
+```bash
+# 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
+
+```python
+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']})")
+```
+
+## Subject Areas Covered
+
+- Agricultural Sciences, Biological Sciences, Health Sciences
+- Engineering, Exact Sciences, Earth Sciences
+- Human Sciences, Social Sciences, Linguistics/Arts
+
+## Unique Value
+
+- **Regional focus**: Primary index for Latin American and Iberian research
+- **Language diversity**: Portuguese, Spanish, English content
+- **100% open access**: All indexed content freely available
+- **Underrepresented research**: Many journals not in Scopus/WoS
+
+## References
+
+- [SciELO](https://scielo.org/)
+- [SciELO Analytics](https://analytics.scielo.org/)
+- [ArticleMeta API](https://articlemeta.scielo.org/)
+- [SciELO Developer Wiki](https://wiki.scielo.org/)

package/skills/literature/search/share-research-api/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: share-research-api
+description: "Discover open access research outputs via the SHARE notification API"
+metadata:
+  openclaw:
+    emoji: "📢"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["SHARE", "open access", "research notification", "COS", "repository aggregator", "preprints"]
+    source: "https://share.osf.io/"
+---
+
+# SHARE Research API
+
+## Overview
+
+SHARE (SHared Access Research Ecosystem) aggregates metadata from 200+ research repositories, preprint servers, and publishers into a unified search API. Operated by the Center for Open Science, it tracks research outputs as they move through the scholarly communication cycle — from preprint to publication. Free, no authentication for search.
+
+## API Endpoints
+
+### Base URL
+
+```
+https://share.osf.io/api/v2
+```
+
+### Search
+
+```bash
+# Text search across all sources
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=climate+change&page[size]=20"
+
+# Filter by type
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=neural+networks&filter[type]=preprint"
+
+# Filter by source
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=genomics&filter[sources]=PubMed+Central"
+
+# Filter by date
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=COVID-19&filter[date][gte]=2024-01-01"
+
+# Filter by tag/subject
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=machine+learning&filter[tags]=deep+learning"
+```
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `q` | Search query | `q=CRISPR` |
+| `filter[type]` | Output type | `preprint`, `article`, `dataset`, `thesis` |
+| `filter[sources]` | Source repository | `PubMed Central`, `arXiv`, `Zenodo` |
+| `filter[date][gte]` | From date | `2024-01-01` |
+| `filter[date][lte]` | Until date | `2026-12-31` |
+| `filter[tags]` | Tag filter | `open+data` |
+| `page[size]` | Results per page | `page[size]=50` |
+| `sort` | Sort order | `-date_updated` |
+
+### Available Sources (200+)
+
+| Source | Type |
+|--------|------|
+| arXiv | Preprints |
+| PubMed Central | Biomedical articles |
+| Zenodo | Multi-discipline repository |
+| Figshare | Data/figures |
+| SSRN | Social science preprints |
+| DataCite | Research data |
+| Institutional repositories | Various |
+
+## Python Usage
+
+```python
+import requests
+
+BASE_URL = "https://share.osf.io/api/v2"
+
+
+def search_share(query: str, output_type: str = None,
+                 source: str = None,
+                 from_date: str = None,
+                 page_size: int = 20) -> list:
+    """Search SHARE for research outputs."""
+    params = {"q": query, "page[size]": page_size}
+    if output_type:
+        params["filter[type]"] = output_type
+    if source:
+        params["filter[sources]"] = source
+    if from_date:
+        params["filter[date][gte]"] = from_date
+
+    resp = requests.get(
+        f"{BASE_URL}/search/creativeworks/",
+        params=params,
+    )
+    resp.raise_for_status()
+    data = resp.json()
+
+    results = []
+    for item in data.get("data", []):
+        attrs = item.get("attributes", {})
+        results.append({
+            "title": attrs.get("title"),
+            "description": (attrs.get("description") or "")[:300],
+            "type": attrs.get("type"),
+            "date": attrs.get("date_updated", "")[:10],
+            "sources": attrs.get("sources", []),
+            "tags": attrs.get("tags", []),
+            "identifiers": attrs.get("identifiers", []),
+        })
+    return results
+
+
+# Example: find recent preprints on a topic
+preprints = search_share(
+    "transformer architecture",
+    output_type="preprint",
+    from_date="2024-01-01",
+)
+for p in preprints[:5]:
+    print(f"[{p['date']}] {p['title']}")
+    print(f"  Type: {p['type']} | Sources: {', '.join(p['sources'][:3])}")
+```
+
+## References
+
+- [SHARE](https://share.osf.io/)
+- [SHARE API Documentation](https://share.osf.io/api/v2/)
+- [Center for Open Science](https://cos.io/)

package/skills/literature/search/worldcat-search-api/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: worldcat-search-api
+description: "Search the world's largest library catalog via OCLC WorldCat API"
+metadata:
+  openclaw:
+    emoji: "🏛️"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["worldcat", "library catalog", "OCLC", "book search", "holdings", "interlibrary loan"]
+    source: "https://developer.api.oclc.org/"
+---
+
+# WorldCat Search API
+
+## Overview
+
+WorldCat is the world's largest network of library content, aggregating catalogs from 10,000+ libraries across 170+ countries. The Search API provides access to 500M+ bibliographic records — books, journals, dissertations, media, and more — with holdings information showing which libraries own each item. Essential for interlibrary loan discovery, collection analysis, and comprehensive bibliographic searches. Requires a WSKey (free for non-commercial use).
+
+## Authentication
+
+```bash
+# Register at https://platform.worldcat.org/
+# Obtain a WSKey (API key) for your application
+
+# OAuth 2.0 client credentials flow
+curl -X POST "https://oauth.oclc.org/token" \
+  -u "$WSKEY_CLIENT_ID:$WSKEY_SECRET" \
+  -d "grant_type=client_credentials&scope=wcapi"
+```
+
+## API Endpoints
+
+### Base URL
+
+```
+https://www.worldcat.org/api/search/
+```
+
+### Search Bibliographic Records
+
+```bash
+# Keyword search
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=machine+learning&limit=25"
+
+# Search by title
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=ti:attention+is+all+you+need"
+
+# Search by author
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=au:hinton+geoffrey"
+
+# Search by ISBN
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=bn:9780262035613"
+
+# Combined filters
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=su:artificial+intelligence+AND+yr:2020-2026&itemType=book"
+```
+
+### Search Indexes
+
+| Index | Prefix | Example |
+|-------|--------|---------|
+| Keyword | (none) | `q=neural+networks` |
+| Title | `ti:` | `q=ti:deep+learning` |
+| Author | `au:` | `q=au:goodfellow` |
+| Subject | `su:` | `q=su:machine+learning` |
+| ISBN | `bn:` | `q=bn:9780262035613` |
+| ISSN | `n:` | `q=n:0028-0836` |
+| OCLC Number | `no:` | `q=no:1234567` |
+| Publisher | `pb:` | `q=pb:MIT+Press` |
+| Year | `yr:` | `q=yr:2024` or `yr:2020-2026` |
+| Language | `la:` | `q=la:eng` |
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `q` | Search query with indexes | `q=ti:BERT+AND+au:devlin` |
+| `limit` | Results per page (max 50) | `limit=25` |
+| `offset` | Pagination offset | `offset=50` |
+| `itemType` | Format filter | `book`, `journal`, `thesis`, `audiobook` |
+| `itemSubType` | Subtype filter | `digital`, `printbook` |
+| `heldByInstitutionID` | Holdings filter | Institution registry ID |
+| `orderBy` | Sort order | `bestMatch`, `mostWidelyHeld`, `datePublished` |
+
+### Get Record by OCLC Number
+
+```bash
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search/brief-bibs/{oclc_number}"
+```
+
+### Holdings / Library Locations
+
+```bash
+# Find libraries holding a specific item
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search/brief-bibs/{oclc_number}/holdings?lat=42.36&lon=-71.06&distance=50"
+```
+
+## Response Structure
+
+```json
+{
+  "numberOfRecords": 1250,
+  "briefRecords": [
+    {
+      "oclcNumber": "1234567890",
+      "title": "Deep Learning",
+      "creator": "Ian Goodfellow; Yoshua Bengio; Aaron Courville",
+      "date": "2016",
+      "publisher": "MIT Press",
+      "language": "eng",
+      "generalFormat": "Book",
+      "specificFormat": "PrintBook",
+      "isbns": ["9780262035613"],
+      "catalogingInfo": {
+        "catalogingAgency": "DLC"
+      },
+      "totalHoldingCount": 3542
+    }
+  ]
+}
+```
+
+## Python Usage
+
+```python
+import os
+import requests
+
+CLIENT_ID = os.environ["OCLC_WSKEY_ID"]
+CLIENT_SECRET = os.environ["OCLC_WSKEY_SECRET"]
+BASE_URL = "https://www.worldcat.org/api/search"
+
+
+def get_token() -> str:
+    """Obtain OAuth token from OCLC."""
+    resp = requests.post(
+        "https://oauth.oclc.org/token",
+        auth=(CLIENT_ID, CLIENT_SECRET),
+        data={"grant_type": "client_credentials", "scope": "wcapi"},
+    )
+    resp.raise_for_status()
+    return resp.json()["access_token"]
+
+
+def search_worldcat(query: str, limit: int = 25,
+                    item_type: str = None) -> list:
+    """Search WorldCat bibliographic records."""
+    token = get_token()
+    params = {"q": query, "limit": limit}
+    if item_type:
+        params["itemType"] = item_type
+
+    resp = requests.get(
+        BASE_URL,
+        headers={"Authorization": f"Bearer {token}"},
+        params=params,
+    )
+    resp.raise_for_status()
+    data = resp.json()
+
+    results = []
+    for rec in data.get("briefRecords", []):
+        results.append({
+            "oclc": rec.get("oclcNumber"),
+            "title": rec.get("title"),
+            "creator": rec.get("creator"),
+            "date": rec.get("date"),
+            "publisher": rec.get("publisher"),
+            "format": rec.get("generalFormat"),
+            "holdings": rec.get("totalHoldingCount", 0),
+            "isbns": rec.get("isbns", []),
+        })
+    return results
+
+
+def find_nearby_holdings(oclc_number: str,
+                         lat: float, lon: float,
+                         distance_km: int = 50) -> list:
+    """Find libraries near a location that hold a specific item."""
+    token = get_token()
+    resp = requests.get(
+        f"{BASE_URL}/brief-bibs/{oclc_number}/holdings",
+        headers={"Authorization": f"Bearer {token}"},
+        params={"lat": lat, "lon": lon, "distance": distance_km},
+    )
+    resp.raise_for_status()
+    return resp.json().get("briefRecords", [])
+
+
+# Example: find widely-held ML textbooks
+books = search_worldcat("su:machine learning AND yr:2020-2026",
+                        item_type="book", limit=10)
+for b in books:
+    print(f"[{b['date']}] {b['title']} — {b['publisher']} "
+          f"(held by {b['holdings']} libraries)")
+```
+
+## Use Cases
+
+1. **Interlibrary loan**: Find nearest library holding a needed item
+2. **Collection gap analysis**: Compare institutional holdings against a bibliography
+3. **Dissertation discovery**: Search theses across global repositories
+4. **Edition tracking**: Find all editions/translations of a work
+5. **Bibliographic verification**: Confirm ISBNs, publication dates, and publishers
+
+## Access Tiers
+
+| Tier | Access | Rate Limit |
+|------|--------|------------|
+| WSKey (free) | Search + brief records | Moderate |
+| Enterprise | Full MARC records + analytics | Higher |
+
+## References
+
+- [WorldCat Search API Documentation](https://developer.api.oclc.org/)
+- [OCLC Developer Network](https://platform.worldcat.org/)
+- [WorldCat.org](https://www.worldcat.org/)