@wentorai/research-plugins 1.1.0 → 1.2.0

package/skills/literature/metadata/crossref-event-data-api/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: crossref-event-data-api
+description: "Track scholarly mentions across the web via Crossref Event Data"
+metadata:
+  openclaw:
+    emoji: "📡"
+    category: "literature"
+    subcategory: "metadata"
+    keywords: ["Crossref", "event data", "altmetrics", "social media mentions", "scholarly impact", "web mentions"]
+    source: "https://www.eventdata.crossref.org/"
+---
+
+# Crossref Event Data API
+
+## Overview
+
+Crossref Event Data tracks where scholarly publications are discussed, shared, and referenced across the open web — Wikipedia citations, Twitter/X mentions, Reddit posts, blog references, policy document citations, and more. Unlike traditional citation counts, Event Data captures real-time online attention to research. Free, no authentication required.
+
+## API Endpoints
+
+### Base URL
+
+```
+https://api.eventdata.crossref.org/v1
+```
+
+### Query Events
+
+```bash
+# Get events for a specific DOI
+curl "https://api.eventdata.crossref.org/v1/events?obj-id=10.1038/nature14539&rows=20"
+
+# Filter by source
+curl "https://api.eventdata.crossref.org/v1/events?\
+obj-id=10.1038/nature14539&source=wikipedia"
+
+# Filter by date range
+curl "https://api.eventdata.crossref.org/v1/events?\
+from-occurred-date=2024-01-01&until-occurred-date=2024-12-31&source=twitter&rows=100"
+
+# Get events about a DOI prefix (publisher level)
+curl "https://api.eventdata.crossref.org/v1/events?obj-id.prefix=10.1371&rows=50"
+
+# Events from a specific source
+curl "https://api.eventdata.crossref.org/v1/events?source=reddit&rows=50"
+```
+
+### Event Sources
+
+| Source | Description | What it tracks |
+|--------|-------------|---------------|
+| `wikipedia` | Wikipedia article references | DOIs cited in Wikipedia |
+| `twitter` | Twitter/X posts | Tweets linking to DOIs |
+| `reddit` | Reddit posts/comments | Reddit links to papers |
+| `hypothesis` | Hypothesis annotations | Web annotations on papers |
+| `newsfeed` | News articles | Media coverage of research |
+| `stackexchange` | Stack Exchange Q&A | Technical discussions |
+| `web` | General web pages | Blog posts, reports |
+| `wordpressdotcom` | WordPress blogs | Blog references |
+| `datacite` | DataCite DOIs | Dataset-paper linkages |
+| `crossref` | Crossref metadata | Reference list updates |
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `obj-id` | DOI of the paper | `obj-id=10.1038/nature14539` |
+| `obj-id.prefix` | DOI prefix (publisher) | `obj-id.prefix=10.1371` |
+| `source` | Event source | `source=wikipedia` |
+| `from-occurred-date` | Events from date | `2024-01-01` |
+| `until-occurred-date` | Events until date | `2024-12-31` |
+| `rows` | Results per page (max 10000) | `rows=100` |
+| `cursor` | Pagination cursor | Returned in response |
+
+## Response Structure
+
+```json
+{
+  "status": "ok",
+  "message-type": "event-list",
+  "message": {
+    "total-results": 245,
+    "events": [
+      {
+        "obj_id": "https://doi.org/10.1038/nature14539",
+        "source_id": "wikipedia",
+        "subj_id": "https://en.wikipedia.org/wiki/Deep_learning",
+        "relation_type_id": "references",
+        "occurred_at": "2024-03-15T10:30:00Z",
+        "subj": {
+          "title": "Deep learning - Wikipedia",
+          "url": "https://en.wikipedia.org/wiki/Deep_learning"
+        }
+      }
+    ],
+    "next-cursor": "abc123..."
+  }
+}
+```
+
+## Python Usage
+
+```python
+import requests
+from collections import Counter
+
+BASE_URL = "https://api.eventdata.crossref.org/v1"
+
+
+def get_events(doi: str, source: str = None,
+               rows: int = 100) -> list:
+    """Get Event Data events for a DOI."""
+    params = {"obj-id": doi, "rows": rows}
+    if source:
+        params["source"] = source
+
+    resp = requests.get(f"{BASE_URL}/events", params=params)
+    resp.raise_for_status()
+    data = resp.json()
+
+    events = []
+    for ev in data.get("message", {}).get("events", []):
+        events.append({
+            "source": ev.get("source_id"),
+            "subject_url": ev.get("subj_id"),
+            "subject_title": ev.get("subj", {}).get("title", ""),
+            "relation": ev.get("relation_type_id"),
+            "date": ev.get("occurred_at", "")[:10],
+        })
+    return events
+
+
+def get_attention_summary(doi: str) -> dict:
+    """Summarize online attention for a paper."""
+    events = get_events(doi, rows=10000)
+    source_counts = Counter(e["source"] for e in events)
+    return {
+        "total_events": len(events),
+        "by_source": dict(source_counts),
+        "first_event": min((e["date"] for e in events), default=None),
+        "latest_event": max((e["date"] for e in events), default=None),
+    }
+
+
+def find_wikipedia_citations(doi: str) -> list:
+    """Find Wikipedia articles that cite a paper."""
+    events = get_events(doi, source="wikipedia")
+    return [
+        {"wikipedia_page": e["subject_title"],
+         "url": e["subject_url"],
+         "date": e["date"]}
+        for e in events
+        if e["relation"] == "references"
+    ]
+
+
+# Example: analyze online attention for a paper
+doi = "10.1038/nature14539"
+summary = get_attention_summary(doi)
+print(f"Total events: {summary['total_events']}")
+for source, count in sorted(summary["by_source"].items(),
+                             key=lambda x: -x[1]):
+    print(f"  {source}: {count}")
+
+# Example: find Wikipedia coverage
+wiki_refs = find_wikipedia_citations(doi)
+for ref in wiki_refs:
+    print(f"Cited in: {ref['wikipedia_page']} ({ref['date']})")
+```
+
+## Use Cases
+
+1. **Altmetrics research**: Measure non-traditional scholarly impact
+2. **Public engagement**: Track how research reaches public audiences
+3. **Policy monitoring**: Discover when research informs policy documents
+4. **Social media analytics**: Track paper sharing on Twitter, Reddit
+5. **Wikipedia coverage**: Find which papers are cited in encyclopedias
+
+## References
+
+- [Crossref Event Data](https://www.eventdata.crossref.org/)
+- [Event Data API Guide](https://www.eventdata.crossref.org/guide/)
+- [Event Data User Guide](https://www.crossref.org/services/event-data/)

package/skills/literature/metadata/doi-content-negotiation/SKILL.md

@@ -0,0 +1,202 @@
+---
+name: doi-content-negotiation
+description: "Retrieve structured metadata from any DOI via HTTP content negotiation"
+metadata:
+  openclaw:
+    emoji: "🔗"
+    category: "literature"
+    subcategory: "metadata"
+    keywords: ["DOI", "content negotiation", "metadata retrieval", "BibTeX", "citation metadata", "linked data"]
+    source: "https://citation.crosscite.org/"
+---
+
+# DOI Content Negotiation
+
+## Overview
+
+Any DOI can return structured metadata in multiple formats through HTTP content negotiation — simply set the `Accept` header when requesting `https://doi.org/{doi}`. This is the most universal way to get citation metadata, BibTeX entries, JSON-LD, and RDF from any publisher without needing a specific API. Works for all 300M+ registered DOIs. Free, no authentication.
+
+## Usage
+
+### Basic Content Negotiation
+
+```bash
+# Get JSON citation metadata (Citeproc JSON)
+curl -LH "Accept: application/vnd.citationstyles.csl+json" \
+  "https://doi.org/10.1038/nature14539"
+
+# Get BibTeX
+curl -LH "Accept: application/x-bibtex" \
+  "https://doi.org/10.1038/nature14539"
+
+# Get RIS format
+curl -LH "Accept: application/x-research-info-systems" \
+  "https://doi.org/10.1038/nature14539"
+
+# Get formatted citation (APA style)
+curl -LH "Accept: text/x-bibliography; style=apa" \
+  "https://doi.org/10.1038/nature14539"
+
+# Get formatted citation (Chicago style)
+curl -LH "Accept: text/x-bibliography; style=chicago-author-date" \
+  "https://doi.org/10.1038/nature14539"
+```
+
+### Available Formats
+
+| Accept Header | Format | Use Case |
+|--------------|--------|----------|
+| `application/vnd.citationstyles.csl+json` | Citeproc JSON | Programmatic metadata |
+| `application/x-bibtex` | BibTeX | LaTeX bibliography |
+| `application/x-research-info-systems` | RIS | Reference managers |
+| `text/x-bibliography; style=apa` | Formatted text | Direct citation |
+| `application/rdf+xml` | RDF/XML | Linked data |
+| `text/turtle` | Turtle RDF | Linked data |
+| `application/vnd.schemaorg.ld+json` | Schema.org JSON-LD | Web metadata |
+| `application/json` | DataCite JSON | DataCite DOIs |
+| `application/vnd.crossref.unixref+xml` | Crossref XML | Full Crossref metadata |
+
+### Citation Styles
+
+Over 9,000 CSL styles available:
+
+```bash
+# APA 7th edition
+style=apa
+
+# Chicago Manual of Style (author-date)
+style=chicago-author-date
+
+# IEEE
+style=ieee
+
+# MLA
+style=modern-language-association
+
+# Harvard
+style=harvard-cite-them-right
+
+# Vancouver (medical)
+style=vancouver
+
+# Nature
+style=nature
+```
+
+## Citeproc JSON Response
+
+```json
+{
+  "DOI": "10.1038/nature14539",
+  "type": "article-journal",
+  "title": "Deep learning",
+  "author": [
+    {"given": "Yann", "family": "LeCun"},
+    {"given": "Yoshua", "family": "Bengio"},
+    {"given": "Geoffrey", "family": "Hinton"}
+  ],
+  "container-title": "Nature",
+  "volume": "521",
+  "issue": "7553",
+  "page": "436-444",
+  "issued": {"date-parts": [[2015, 5, 28]]},
+  "publisher": "Springer Science and Business Media LLC",
+  "ISSN": ["0028-0836", "1476-4687"],
+  "URL": "http://dx.doi.org/10.1038/nature14539",
+  "abstract": "Deep learning allows computational models..."
+}
+```
+
+## Python Usage
+
+```python
+import requests
+
+
+def get_metadata(doi: str) -> dict:
+    """Get structured metadata for a DOI."""
+    resp = requests.get(
+        f"https://doi.org/{doi}",
+        headers={"Accept": "application/vnd.citationstyles.csl+json"},
+        allow_redirects=True,
+    )
+    resp.raise_for_status()
+    return resp.json()
+
+
+def get_bibtex(doi: str) -> str:
+    """Get BibTeX entry for a DOI."""
+    resp = requests.get(
+        f"https://doi.org/{doi}",
+        headers={"Accept": "application/x-bibtex"},
+        allow_redirects=True,
+    )
+    resp.raise_for_status()
+    return resp.text
+
+
+def get_formatted_citation(doi: str,
+                            style: str = "apa") -> str:
+    """Get a formatted citation string."""
+    resp = requests.get(
+        f"https://doi.org/{doi}",
+        headers={
+            "Accept": f"text/x-bibliography; style={style}",
+        },
+        allow_redirects=True,
+    )
+    resp.raise_for_status()
+    return resp.text.strip()
+
+
+def batch_bibtex(dois: list) -> str:
+    """Generate BibTeX file for multiple DOIs."""
+    entries = []
+    for doi in dois:
+        try:
+            bib = get_bibtex(doi)
+            entries.append(bib)
+        except requests.HTTPError:
+            entries.append(f"% Failed to resolve: {doi}")
+    return "\n\n".join(entries)
+
+
+# Example: get metadata
+meta = get_metadata("10.1038/nature14539")
+authors = ", ".join(
+    f"{a['given']} {a['family']}" for a in meta.get("author", [])
+)
+print(f"{meta['title']}")
+print(f"  Authors: {authors}")
+print(f"  {meta.get('container-title')} ({meta.get('volume')})")
+
+# Example: get BibTeX
+bibtex = get_bibtex("10.1038/nature14539")
+print(f"\nBibTeX:\n{bibtex}")
+
+# Example: formatted APA citation
+apa = get_formatted_citation("10.1038/nature14539", "apa")
+print(f"\nAPA: {apa}")
+
+# Example: batch export
+bibliography = batch_bibtex([
+    "10.1038/nature14539",
+    "10.5555/3295222.3295349",
+])
+with open("references.bib", "w") as f:
+    f.write(bibliography)
+```
+
+## Use Cases
+
+1. **Bibliography generation**: Export BibTeX/RIS for any DOI list
+2. **Citation formatting**: Generate properly formatted citations
+3. **Metadata extraction**: Get structured metadata for data pipelines
+4. **Linked data**: Retrieve RDF for knowledge graph construction
+5. **Verification**: Confirm publication details from authoritative source
+
+## References
+
+- [DOI Content Negotiation](https://citation.crosscite.org/docs.html)
+- [Crossref Content Negotiation](https://www.crossref.org/documentation/retrieve-metadata/content-negotiation/)
+- [CSL Style Repository](https://github.com/citation-style-language/styles)

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

@@ -0,0 +1,153 @@
+---
+name: orkg-api
+description: "Query the Open Research Knowledge Graph for structured research data"
+metadata:
+  openclaw:
+    emoji: "🕸️"
+    category: "literature"
+    subcategory: "metadata"
+    keywords: ["knowledge graph", "research data", "structured research", "ORKG", "research contributions", "scholarly graph"]
+    source: "https://orkg.org/"
+---
+
+# Open Research Knowledge Graph (ORKG) API
+
+## Overview
+
+The Open Research Knowledge Graph (ORKG) transforms unstructured scholarly articles into structured, machine-readable research contributions. Unlike traditional databases that store metadata (title, authors, DOI), ORKG captures the semantic content — research problems, methods, results, and their relationships. The REST API enables querying, creating, and comparing research contributions programmatically. Free, no authentication required for read operations.
+
+## API Endpoints
+
+### Base URL
+
+```
+https://orkg.org/api/
+```
+
+### Search Papers
+
+```bash
+# Search papers in ORKG
+curl "https://orkg.org/api/papers?q=climate+change+adaptation&size=20"
+
+# Get paper details by ID
+curl "https://orkg.org/api/papers/R12345"
+```
+
+### Search Resources
+
+```bash
+# Search any resource (papers, predicates, comparisons)
+curl "https://orkg.org/api/resources?q=machine+learning&size=20"
+
+# Filter by class
+curl "https://orkg.org/api/resources?q=BERT&exact=false&classes=Paper"
+```
+
+### Comparisons
+
+ORKG's unique feature — structured side-by-side comparison of papers:
+
+```bash
+# List comparisons
+curl "https://orkg.org/api/comparisons?size=10"
+
+# Get a specific comparison
+curl "https://orkg.org/api/comparisons/R54321"
+
+# Search comparisons
+curl "https://orkg.org/api/comparisons?q=sentiment+analysis"
+```
+
+### Research Contributions
+
+```bash
+# Get contributions of a paper
+curl "https://orkg.org/api/papers/R12345/contributions"
+
+# A contribution describes what a paper contributes:
+# - Research problem addressed
+# - Method used
+# - Results achieved
+# - Materials/datasets used
+```
+
+## Python Usage
+
+```python
+import requests
+
+BASE_URL = "https://orkg.org/api"
+
+def search_orkg_papers(query: str, size: int = 20) -> list:
+    """Search papers in the Open Research Knowledge Graph."""
+    resp = requests.get(f"{BASE_URL}/papers", params={"q": query, "size": size})
+    resp.raise_for_status()
+    data = resp.json()
+
+    papers = []
+    for item in data.get("content", []):
+        papers.append({
+            "id": item.get("id"),
+            "title": item.get("title"),
+            "created": item.get("created_at"),
+            "contributions": item.get("contributions", [])
+        })
+    return papers
+
+def get_paper_contributions(paper_id: str) -> dict:
+    """Get structured research contributions for a paper."""
+    resp = requests.get(f"{BASE_URL}/papers/{paper_id}/contributions")
+    resp.raise_for_status()
+    return resp.json()
+
+def search_comparisons(topic: str) -> list:
+    """Find structured paper comparisons on a topic."""
+    resp = requests.get(f"{BASE_URL}/comparisons", params={"q": topic, "size": 10})
+    resp.raise_for_status()
+    return resp.json().get("content", [])
+
+# Example usage
+papers = search_orkg_papers("transfer learning NLP")
+for p in papers:
+    print(f"[{p['id']}] {p['title']}")
+
+comparisons = search_comparisons("named entity recognition")
+for c in comparisons:
+    print(f"Comparison: {c.get('title')} ({len(c.get('contributions', []))} papers)")
+```
+
+## Key Concepts
+
+| Concept | Description | Example |
+|---------|-------------|---------|
+| **Paper** | A scholarly article with metadata | "Attention Is All You Need" |
+| **Contribution** | What a paper contributes to knowledge | "Proposes self-attention mechanism" |
+| **Research Problem** | The problem a contribution addresses | "Machine translation quality" |
+| **Predicate** | A relationship type | "has_method", "has_result", "uses_dataset" |
+| **Comparison** | Side-by-side structured comparison | "Transformer variants comparison" |
+| **Resource** | Any entity in the knowledge graph | A method, dataset, metric, or concept |
+
+## ORKG vs Traditional Databases
+
+| Feature | Traditional (S2, Crossref) | ORKG |
+|---------|---------------------------|------|
+| Content | Metadata (title, DOI, citations) | Semantic content (methods, results) |
+| Structure | Flat records | Knowledge graph with relationships |
+| Comparison | Manual (read each paper) | Automated structured comparisons |
+| Machine-readable | Bibliographic metadata only | Research contributions structured |
+| Coverage | Broad (200M+ papers) | Deep but narrower (~50K papers) |
+
+## Use Cases
+
+1. **Literature surveys**: Find existing comparisons to quickly understand a field
+2. **Method selection**: Compare methods across papers on structured criteria
+3. **Gap analysis**: Identify research problems without solutions
+4. **Reproducibility**: Access structured descriptions of experimental setups
+
+## References
+
+- [ORKG Website](https://orkg.org/)
+- [ORKG API Documentation](https://orkg.org/api/)
+- [ORKG Help Center](https://orkg.org/help-center)
+- Jaradeh, M.Y., et al. (2019). "Open Research Knowledge Graph: Next Generation Infrastructure for Semantic Scholarly Knowledge." *K-CAP 2019*.