@wentorai/research-plugins 1.1.0 → 1.2.0

package/skills/literature/search/chatpaper-guide/SKILL.md

@@ -4,8 +4,8 @@ description: "Use ChatPaper to summarize and search arXiv papers with LLM assist
 metadata:
   openclaw:
     emoji: "📑"
-    category: literature
-    subcategory: search
+    category: "literature"
+    subcategory: "search"
     keywords: ["arxiv", "paper-summarization", "literature-search", "chatgpt", "research-acceleration"]
     source: "https://github.com/kaixindelele/ChatPaper"
 ---

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

@@ -0,0 +1,183 @@
+---
+name: citeseerx-api
+description: "Search computer science literature via the CiteSeerX digital library"
+metadata:
+  openclaw:
+    emoji: "📄"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["CiteSeerX", "computer science", "citation index", "academic search", "CS literature", "autonomous citation"]
+    source: "https://citeseerx.ist.psu.edu/"
+---
+
+# CiteSeerX API
+
+## Overview
+
+CiteSeerX is a scientific literature digital library focusing on computer and information science, with 10M+ documents and 100M+ citations. It provides autonomous citation indexing — extracting and linking citations without manual curation. The API supports document search, citation lookup, and metadata retrieval. Free, no authentication required.
+
+## API Endpoints
+
+### Base URL
+
+```
+https://citeseerx.ist.psu.edu/api
+```
+
+### Document Search
+
+```bash
+# Keyword search
+curl "https://citeseerx.ist.psu.edu/api/search?q=graph+neural+networks&start=0&rows=20"
+
+# Search by title
+curl "https://citeseerx.ist.psu.edu/api/search?q=title:attention+is+all+you+need"
+
+# Search by author
+curl "https://citeseerx.ist.psu.edu/api/search?q=author:hinton&rows=25"
+
+# Filter by year
+curl "https://citeseerx.ist.psu.edu/api/search?q=federated+learning&year=2024"
+
+# Sort by citation count
+curl "https://citeseerx.ist.psu.edu/api/search?q=reinforcement+learning&sort=citationCount+desc"
+```
+
+### Get Document by ID
+
+```bash
+# Get document metadata
+curl "https://citeseerx.ist.psu.edu/api/document?doi=10.1.1.123.456"
+
+# Get citations for a document
+curl "https://citeseerx.ist.psu.edu/api/citations?doi=10.1.1.123.456"
+
+# Get citing documents
+curl "https://citeseerx.ist.psu.edu/api/citedby?doi=10.1.1.123.456"
+```
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `q` | Search query | `q=deep+learning` |
+| `start` | Pagination offset | `start=20` |
+| `rows` | Results per page | `rows=50` |
+| `sort` | Sort field | `citationCount desc` |
+| `year` | Filter by year | `year=2024` |
+| `doi` | CiteSeerX document ID | `doi=10.1.1.123.456` |
+
+## Response Structure
+
+```json
+{
+  "response": {
+    "numFound": 5200,
+    "docs": [
+      {
+        "id": "10.1.1.123.456",
+        "title": "Graph Neural Networks: A Review",
+        "authors": ["Zhou, Jie", "Cui, Ganqu"],
+        "year": 2020,
+        "abstract": "Graph neural networks have been widely applied...",
+        "venue": "AI Open",
+        "citationCount": 3500,
+        "url": "https://citeseerx.ist.psu.edu/doc/10.1.1.123.456"
+      }
+    ]
+  }
+}
+```
+
+## Python Usage
+
+```python
+import requests
+
+BASE_URL = "https://citeseerx.ist.psu.edu/api"
+
+
+def search_citeseerx(query: str, rows: int = 20,
+                     sort_by_citations: bool = False) -> list:
+    """Search CiteSeerX computer science literature."""
+    params = {
+        "q": query,
+        "rows": rows,
+        "start": 0,
+    }
+    if sort_by_citations:
+        params["sort"] = "citationCount desc"
+
+    resp = requests.get(f"{BASE_URL}/search", params=params, timeout=30)
+    resp.raise_for_status()
+    data = resp.json()
+
+    results = []
+    for doc in data.get("response", {}).get("docs", []):
+        results.append({
+            "id": doc.get("id"),
+            "title": doc.get("title"),
+            "authors": doc.get("authors", []),
+            "year": doc.get("year"),
+            "venue": doc.get("venue"),
+            "citations": doc.get("citationCount", 0),
+            "abstract": doc.get("abstract", "")[:300],
+            "url": doc.get("url"),
+        })
+    return results
+
+
+def get_citations(doc_id: str) -> list:
+    """Get papers cited by a document."""
+    resp = requests.get(
+        f"{BASE_URL}/citations",
+        params={"doi": doc_id},
+        timeout=30,
+    )
+    resp.raise_for_status()
+    return resp.json().get("citations", [])
+
+
+def get_cited_by(doc_id: str) -> list:
+    """Get papers that cite a document."""
+    resp = requests.get(
+        f"{BASE_URL}/citedby",
+        params={"doi": doc_id},
+        timeout=30,
+    )
+    resp.raise_for_status()
+    return resp.json().get("citedby", [])
+
+
+# Example: find most-cited CS papers on a topic
+papers = search_citeseerx("knowledge distillation",
+                          rows=10, sort_by_citations=True)
+for p in papers:
+    print(f"[{p['year']}] {p['title']} (cited: {p['citations']})")
+
+# Example: citation chain analysis
+if papers:
+    refs = get_citations(papers[0]["id"])
+    print(f"\nReferences of top paper ({len(refs)} citations):")
+    for r in refs[:5]:
+        print(f"  -> {r.get('title', 'Unknown')}")
+```
+
+## Unique Features
+
+- **Autonomous citation indexing**: Automatically extracts and links citations from PDF
+- **CS focus**: Deep coverage of computer science subdisciplines
+- **Citation graph**: Full bidirectional citation linking
+- **Free PDF access**: Links to crawled open-access PDFs
+
+## Limitations
+
+- Primarily CS/information science (limited other fields)
+- Some metadata may be noisy (auto-extracted from PDF)
+- Coverage strongest for older papers (2000-2020)
+
+## References
+
+- [CiteSeerX](https://citeseerx.ist.psu.edu/)
+- [CiteSeerX Documentation](https://citeseerx.ist.psu.edu/about)
+- Giles, C.L., Bollacker, K.D., Lawrence, S. (1998). "CiteSeer: An Automatic Citation Indexing System." *ACM DL*.

package/skills/literature/search/deepgit-search-guide/SKILL.md

@@ -6,8 +6,8 @@ author: wentor-community
 source: https://github.com/DeepGit/DeepGit
 metadata:
   openclaw:
-    category: literature
-    subcategory: search
+    category: "literature"
+    subcategory: "search"
     keywords:
       - git-search
       - code-discovery

package/skills/literature/search/eric-education-api/SKILL.md

@@ -0,0 +1,199 @@
+---
+name: eric-education-api
+description: "Search 2M+ education research records via the ERIC database API"
+metadata:
+  openclaw:
+    emoji: "🎓"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["ERIC", "education research", "IES", "pedagogy", "teaching", "educational technology"]
+    source: "https://eric.ed.gov/"
+---
+
+# ERIC (Education Resources Information Center) API
+
+## Overview
+
+ERIC is the world's largest digital library of education research, sponsored by the U.S. Institute of Education Sciences (IES). It indexes 2M+ records including journal articles, reports, conference papers, and dissertations covering all aspects of education. The API provides free, unauthenticated access to metadata and links to full text where available.
+
+## API Endpoints
+
+### Base URL
+
+```
+https://api.ies.ed.gov/eric/
+```
+
+### Search
+
+```bash
+# Basic keyword search
+curl "https://api.ies.ed.gov/eric/?search=online+learning&format=json&rows=20"
+
+# Search in specific fields
+curl "https://api.ies.ed.gov/eric/?search=title:\"blended learning\"&format=json"
+
+# Filter by publication date
+curl "https://api.ies.ed.gov/eric/?search=STEM+education&start=0&rows=25&\
+publicationdatestart=2023-01-01&publicationdateend=2026-12-31&format=json"
+
+# Filter by publication type
+curl "https://api.ies.ed.gov/eric/?search=formative+assessment&\
+publicationtype=Journal+Articles&format=json"
+
+# Filter by descriptor (ERIC thesaurus term)
+curl "https://api.ies.ed.gov/eric/?search=descriptor:\"Higher Education\"&format=json"
+
+# Peer-reviewed only
+curl "https://api.ies.ed.gov/eric/?search=metacognition&peerreviewed=true&format=json"
+```
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `search` | Free-text or field search | `search=adaptive+learning` |
+| `format` | Response format | `json` or `xml` |
+| `rows` | Results per page (max 200) | `rows=50` |
+| `start` | Pagination offset | `start=50` |
+| `publicationtype` | Document type | `Journal Articles`, `Reports`, `Dissertations/Theses` |
+| `publicationdatestart` | From date | `2024-01-01` |
+| `publicationdateend` | To date | `2026-12-31` |
+| `peerreviewed` | Peer-reviewed filter | `true` or `false` |
+| `descriptor` | ERIC thesaurus term | `descriptor:"Distance Education"` |
+| `educationlevel` | Education level | `Higher Education`, `Elementary Education` |
+| `subject` | Subject area | `subject:"Mathematics Education"` |
+
+### Search Fields
+
+| Field | Description |
+|-------|-------------|
+| `title` | Article title |
+| `author` | Author name |
+| `descriptor` | ERIC controlled vocabulary term |
+| `source` | Journal/source name |
+| `abstract` | Abstract text |
+| `id` | ERIC document ID (e.g., EJ1234567) |
+
+### Publication Types
+
+| Type | Description |
+|------|-------------|
+| `Journal Articles` | Peer-reviewed journal articles |
+| `Reports - Research` | Research reports |
+| `Reports - Descriptive` | Descriptive reports |
+| `Reports - Evaluative` | Program evaluations |
+| `Dissertations/Theses` | Graduate research |
+| `Speeches/Meeting Papers` | Conference presentations |
+| `Books` | Books and book chapters |
+
+## Response Structure
+
+```json
+{
+  "response": {
+    "numFound": 8450,
+    "start": 0,
+    "docs": [
+      {
+        "id": "EJ1389012",
+        "title": "Effects of AI Tutoring on Student Learning Outcomes",
+        "author": ["Smith, John", "Chen, Wei"],
+        "source": "Journal of Educational Technology",
+        "publicationdateyear": 2024,
+        "description": "This study examines the impact of AI-powered tutoring...",
+        "descriptor": ["Artificial Intelligence", "Tutoring", "Academic Achievement"],
+        "educationlevel": ["Higher Education"],
+        "peerreviewed": "T",
+        "url": "https://eric.ed.gov/?id=EJ1389012",
+        "publicationtype": "Journal Articles",
+        "issn": "1234-5678"
+      }
+    ]
+  }
+}
+```
+
+## Python Usage
+
+```python
+import requests
+
+BASE_URL = "https://api.ies.ed.gov/eric/"
+
+
+def search_eric(query: str, rows: int = 25,
+                peer_reviewed: bool = True,
+                pub_type: str = None,
+                from_year: int = None) -> list:
+    """Search the ERIC education research database."""
+    params = {
+        "search": query,
+        "format": "json",
+        "rows": rows,
+    }
+    if peer_reviewed:
+        params["peerreviewed"] = "true"
+    if pub_type:
+        params["publicationtype"] = pub_type
+    if from_year:
+        params["publicationdatestart"] = f"{from_year}-01-01"
+
+    resp = requests.get(BASE_URL, params=params)
+    resp.raise_for_status()
+    data = resp.json()
+
+    results = []
+    for doc in data.get("response", {}).get("docs", []):
+        results.append({
+            "id": doc.get("id"),
+            "title": doc.get("title"),
+            "authors": doc.get("author", []),
+            "source": doc.get("source"),
+            "year": doc.get("publicationdateyear"),
+            "abstract": doc.get("description", "")[:300],
+            "descriptors": doc.get("descriptor", []),
+            "level": doc.get("educationlevel", []),
+            "url": doc.get("url"),
+        })
+    return results
+
+
+def search_by_descriptor(descriptor: str, rows: int = 50) -> list:
+    """Search using ERIC thesaurus controlled vocabulary."""
+    return search_eric(f'descriptor:"{descriptor}"', rows=rows)
+
+
+# Example: find recent AI in education research
+papers = search_eric("artificial intelligence classroom",
+                     from_year=2023, rows=10)
+for p in papers:
+    print(f"[{p['year']}] {p['title']}")
+    print(f"  Descriptors: {', '.join(p['descriptors'][:5])}")
+
+# Example: search by ERIC descriptor
+papers = search_by_descriptor("Gamification")
+for p in papers:
+    print(f"{p['id']}: {p['title']} — {p['source']}")
+```
+
+## ERIC Thesaurus
+
+ERIC uses a controlled vocabulary of 12,000+ descriptors for consistent indexing. Key descriptors include:
+
+| Descriptor | Coverage |
+|------------|----------|
+| `Distance Education` | Online/remote learning |
+| `Educational Technology` | EdTech tools and methods |
+| `Higher Education` | University-level education |
+| `STEM Education` | Science, technology, engineering, math |
+| `Teacher Education` | Teacher training and development |
+| `Assessment` | Testing and evaluation |
+| `Curriculum Development` | Curriculum design |
+| `Special Education` | Inclusive education |
+
+## References
+
+- [ERIC Website](https://eric.ed.gov/)
+- [ERIC API Guide](https://eric.ed.gov/pdf/ERIC_API.pdf)
+- [ERIC Thesaurus](https://eric.ed.gov/thesaurus)

package/skills/literature/search/findpapers-guide/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: findpapers-guide
+description: "Search multiple academic databases simultaneously with Findpapers"
+metadata:
+  openclaw:
+    emoji: "🔍"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["Findpapers", "multi-database search", "systematic review", "arXiv", "PubMed", "Scopus", "IEEE"]
+    source: "https://github.com/jonatasgrosman/findpapers"
+---
+
+# Findpapers Guide
+
+## Overview
+
+Findpapers is a Python tool for searching multiple academic databases simultaneously — arXiv, bioRxiv, IEEE, medRxiv, PubMed, and Scopus — using a single query. It automates the tedious process of running the same search across multiple platforms, deduplicates results, and exports to structured formats for systematic reviews.
+
+## Installation
+
+```bash
+pip install findpapers
+```
+
+## Basic Usage
+
+### Search Multiple Databases
+
+```python
+import findpapers
+import datetime
+
+# Define search
+query = '([deep learning] AND [medical imaging]) AND NOT [survey]'
+since = datetime.date(2022, 1, 1)
+until = datetime.date(2026, 12, 31)
+
+# Run search across all databases
+findpapers.search(
+    outputpath="search_results.json",
+    query=query,
+    since=since,
+    until=until,
+    databases=["arxiv", "pubmed", "ieee", "scopus"],
+    limit_per_database=200,
+)
+```
+
+### Query Syntax
+
+```python
+# Boolean operators: AND, OR, NOT
+# Brackets for grouping
+# Terms in square brackets
+
+# Example: find NLP papers about healthcare
+query = '[natural language processing] AND ([healthcare] OR [clinical])'
+
+# Example: exclude surveys
+query = '[transformer] AND [attention] AND NOT [survey]'
+
+# Example: specific domain
+query = '[reinforcement learning] AND [robotics] AND [simulation]'
+```
+
+### Refine and Filter Results
+
+```python
+# Load previous search
+search = findpapers.load("search_results.json")
+
+# Interactive refinement (in Jupyter/terminal)
+findpapers.refine(
+    inputpath="search_results.json",
+    categories=["relevant", "maybe", "irrelevant"],
+)
+
+# Programmatic filtering
+for paper in search.papers:
+    if paper.citations and paper.citations > 50:
+        paper.selected = True
+```
+
+### Export Results
+
+```python
+# Export to BibTeX
+findpapers.generate_bibtex(
+    inputpath="search_results.json",
+    outputpath="references.bib",
+    only_selected=True,
+)
+
+# Export to CSV
+findpapers.generate_csv(
+    inputpath="search_results.json",
+    outputpath="papers.csv",
+)
+```
+
+## Database Configuration
+
+### API Keys (Optional)
+
+```python
+# Scopus requires an Elsevier API key
+# IEEE requires an IEEE Xplore API key
+# arXiv and PubMed are free
+
+import os
+os.environ["SCOPUS_API_TOKEN"] = "your-scopus-key"
+os.environ["IEEE_API_TOKEN"] = "your-ieee-key"
+```
+
+### Database Support
+
+| Database | API Key | Content |
+|----------|---------|---------|
+| arXiv | Not needed | Preprints (CS, physics, math) |
+| PubMed | Not needed | Biomedical literature |
+| bioRxiv | Not needed | Biology preprints |
+| medRxiv | Not needed | Medical preprints |
+| IEEE | Optional | Engineering and CS |
+| Scopus | Required | Multi-discipline |
+
+## Systematic Review Workflow
+
+```python
+import findpapers
+import datetime
+
+# Step 1: Define protocol
+query = '[machine learning] AND [drug discovery]'
+since = datetime.date(2020, 1, 1)
+
+# Step 2: Search
+findpapers.search(
+    outputpath="slr_search.json",
+    query=query,
+    since=since,
+    limit_per_database=500,
+)
+
+# Step 3: Remove duplicates (automatic)
+search = findpapers.load("slr_search.json")
+print(f"Found {len(search.papers)} unique papers")
+
+# Step 4: Screen titles/abstracts
+findpapers.refine("slr_search.json",
+                   categories=["include", "exclude", "uncertain"])
+
+# Step 5: Export included papers
+findpapers.generate_bibtex("slr_search.json", "included.bib",
+                            only_selected=True)
+```
+
+## CLI Usage
+
+```bash
+# Search from command line
+findpapers search "search.json" \
+  --query "[climate change] AND [adaptation]" \
+  --since 2022-01-01 \
+  --databases arxiv pubmed
+
+# Refine results interactively
+findpapers refine "search.json"
+
+# Export to BibTeX
+findpapers bibtex "search.json" "refs.bib" --only-selected
+```
+
+## References
+
+- [Findpapers GitHub](https://github.com/jonatasgrosman/findpapers)
+- [Findpapers PyPI](https://pypi.org/project/findpapers/)
+- Grosman, J. & Ciferri, R. (2020). "Findpapers: A tool for systematic literature searching."