@wentorai/research-plugins 1.3.2 → 1.4.2

package/skills/domains/law/uk-legislation-api/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: uk-legislation-api
+description: "Access UK laws and statutory instruments via the Legislation.gov.uk API"
+metadata:
+  openclaw:
+    emoji: "⚖️"
+    category: "domains"
+    subcategory: "law"
+    keywords: ["UK law", "legislation", "statutory instruments", "legal research", "Parliament", "regulatory analysis"]
+    source: "https://www.legislation.gov.uk"
+---
+
+# UK Legislation API (legislation.gov.uk)
+
+## Overview
+
+The Legislation.gov.uk API, maintained by The National Archives, provides open access to the full text of UK legislation from 1267 to the present day. The database covers over 100,000 items including Acts of Parliament, Statutory Instruments, Scottish and Welsh legislation, and Northern Ireland statutes. All data is available as structured XML with Dublin Core metadata, Atom feeds, and HTML. The API supports point-in-time versions showing how legislation read at any given date, plus amendment tracking.
+
+## Authentication
+
+No authentication or API key is required. The API is fully open. Respect rate limits by adding reasonable delays between bulk requests.
+
+## URL Structure
+
+All legislation follows the pattern:
+
+```
+https://www.legislation.gov.uk/{type}/{year}/{number}
+```
+
+### Legislation Types
+
+| Type Code | Description | Example |
+|-----------|-------------|---------|
+| `ukpga` | UK Public General Act | `/ukpga/2010/15` (Equality Act 2010) |
+| `uksi` | UK Statutory Instrument | `/uksi/2020/1374` |
+| `asp` | Act of Scottish Parliament | `/asp/2020/13` |
+| `asc` | Act of Senedd Cymru (Wales) | `/asc/2021/4` |
+| `nia` | Northern Ireland Act | `/nia/2022/2` |
+| `ukla` | UK Local Act | `/ukla/2008/1` |
+| `ukdsi` | UK Draft Statutory Instrument | `/ukdsi/2023/123` |
+| `eur` | Retained EU Legislation | `/eur/2016/679` (GDPR) |
+
+## Core Endpoints
+
+### Full Legislation Text (XML)
+
+```bash
+# Fetch the Equality Act 2010 — returns structured XML with Dublin Core metadata
+curl "https://www.legislation.gov.uk/ukpga/2010/15/data.xml"
+# Response: <Legislation DocumentURI="http://www.legislation.gov.uk/ukpga/2010/15"
+#   NumberOfProvisions="564">
+#   <dc:title>Equality Act 2010</dc:title>
+#   <dc:description>An Act to make provision to require Ministers...</dc:description>
+
+# Fetch Data Protection Act 2018
+curl "https://www.legislation.gov.uk/ukpga/2018/12/data.xml"
+# Response: <dc:title>Data Protection Act 2018</dc:title>
+#   NumberOfProvisions="1181"
+
+# Fetch a Statutory Instrument
+curl "https://www.legislation.gov.uk/uksi/2020/1374/data.xml"
+# Response: <dc:title>The Health Protection (Coronavirus, Restric...</dc:title>
+```
+
+### Specific Sections
+
+```bash
+# Fetch a single section
+curl "https://www.legislation.gov.uk/ukpga/2010/15/section/1/data.xml"
+
+# Fetch table of contents
+curl "https://www.legislation.gov.uk/ukpga/2010/15/contents/data.xml"
+
+# Fetch a specific Part
+curl "https://www.legislation.gov.uk/ukpga/2010/15/part/1/data.xml"
+
+# Fetch a Schedule
+curl "https://www.legislation.gov.uk/ukpga/2010/15/schedule/1/data.xml"
+```
+
+### Search and Discovery
+
+```bash
+# Search by title — returns HTTP 300 with multiple matches
+curl "https://www.legislation.gov.uk/id?title=equality+act"
+
+# Browse by type, title keyword, and year
+curl "https://www.legislation.gov.uk/ukpga?title=data+protection&year=2018"
+
+# List recent Acts via Atom feed
+curl "https://www.legislation.gov.uk/new/ukpga/data.feed"
+# Response: <openSearch:totalResults> with <entry> elements per Act
+```
+
+### Amendment Tracking
+
+```bash
+# Changes affecting a specific Act (Atom feed, paginated)
+curl "https://www.legislation.gov.uk/changes/affected/ukpga/2010/15/data.feed"
+# Response: <title>Changes to Legislation</title>
+#   <leg:totalPages>25</leg:totalPages>
+#   Each <entry> describes one amendment with source and target provisions
+
+# Changes made BY a specific Act
+curl "https://www.legislation.gov.uk/changes/affecting/ukpga/2010/15/data.feed"
+```
+
+### Point-in-Time Versions
+
+```bash
+# Legislation as it stood on a specific date
+curl "https://www.legislation.gov.uk/ukpga/2010/15/2015-01-01/data.xml"
+
+# Enacted (original) version
+curl "https://www.legislation.gov.uk/ukpga/2010/15/enacted/data.xml"
+```
+
+## Data Formats
+
+| Suffix | Format | Content-Type |
+|--------|--------|-------------|
+| `/data.xml` | Legislation XML (CLML) | `application/xml` |
+| `/data.feed` | Atom feed | `application/atom+xml` |
+| `/data.csv` | CSV export | `text/csv` |
+| (none) | HTML rendering | `text/html` |
+
+The primary XML format uses the Crown Legislation Markup Language (CLML) schema with namespaces for `legislation`, `ukm:Metadata`, and Dublin Core (`dc:`, `dct:`) elements. Each document includes `NumberOfProvisions`, `RestrictExtent` (geographic applicability like `E+W+S+N.I.`), and `RestrictStartDate`.
+
+## Academic Use Cases
+
+- **Legislative history**: Track how a statute has evolved using point-in-time versions and amendment feeds
+- **Policy analysis**: Compare regulatory regimes across UK jurisdictions (England, Scotland, Wales, NI)
+- **Corpus linguistics**: Build legislative text corpora from XML for NLP analysis of legal language
+- **Regulatory impact studies**: Use the changes feed to measure legislative amendment frequency
+- **Comparative law**: Contrast UK statutory instruments with primary legislation structure
+- **Brexit research**: Analyse retained EU legislation (type `eur`) and its UK modifications
+
+## Python Usage
+
+```python
+import requests
+from xml.etree import ElementTree as ET
+
+BASE = "https://www.legislation.gov.uk"
+NS = {"leg": "http://www.legislation.gov.uk/namespaces/legislation",
+      "ukm": "http://www.legislation.gov.uk/namespaces/metadata",
+      "dc": "http://purl.org/dc/elements/1.1/",
+      "atom": "http://www.w3.org/2005/Atom"}
+
+def get_legislation(leg_type: str, year: int, number: int) -> dict:
+    """Fetch UK legislation metadata and full XML."""
+    url = f"{BASE}/{leg_type}/{year}/{number}/data.xml"
+    resp = requests.get(url)
+    resp.raise_for_status()
+    root = ET.fromstring(resp.content)
+    meta = root.find(".//ukm:Metadata", NS)
+    return {
+        "title": meta.findtext("dc:title", namespaces=NS),
+        "description": meta.findtext("dc:description", namespaces=NS),
+        "provisions": root.attrib.get("NumberOfProvisions"),
+        "extent": root.attrib.get("RestrictExtent"),
+        "uri": root.attrib.get("DocumentURI"),
+        "xml": resp.content
+    }
+
+# Example: fetch the Equality Act 2010
+act = get_legislation("ukpga", 2010, 15)
+print(f"{act['title']} — {act['provisions']} provisions, extent: {act['extent']}")
+# Output: Equality Act 2010 — 564 provisions, extent: E+W+S+N.I.
+```
+
+## References
+
+- [Legislation.gov.uk API Documentation](https://www.legislation.gov.uk/developer)
+- [CLML Schema Documentation](https://legislation.github.io/clml-schema/)
+- [Legislation.gov.uk URI Scheme](https://www.legislation.gov.uk/developer/uris)
+- [The National Archives](https://www.nationalarchives.gov.uk/)
+- [Atom Feed Specification](https://www.legislation.gov.uk/developer/formats/atom)

package/skills/literature/discovery/SKILL.md

@@ -16,5 +16,5 @@ Select the skill matching the user's need, then `read` its SKILL.md.
 | [papers-we-love-guide](./papers-we-love-guide/SKILL.md) | Community-curated directory of influential CS research papers |
 | [rss-paper-feeds](./rss-paper-feeds/SKILL.md) | Set up RSS feeds and alerts to track new publications in your research area |
 | [semantic-paper-radar](./semantic-paper-radar/SKILL.md) | Semantic literature discovery and synthesis using embeddings |
-| [semantic-scholar-recs-guide](./semantic-scholar-recs-guide/SKILL.md) | Using Semantic Scholar recommendations API for paper discovery |
+| [semantic-scholar-recs-guide](./semantic-scholar-recs-guide/SKILL.md) | Paper discovery via recommendation APIs (OpenAlex, CrossRef citation networks) |
 | [zotero-arxiv-daily-guide](./zotero-arxiv-daily-guide/SKILL.md) | Guide to Zotero arXiv Daily for personalized daily paper recommendations |

package/skills/literature/discovery/citation-alert-guide/SKILL.md

@@ -24,7 +24,7 @@ A skill for setting up automated citation alerts and tracking systems that notif
 | Web of Science | Citation alert, search alert, journal ToC | WoS-indexed journals | Institutional |
 | Scopus | Citation alert, search alert, author alert | Scopus-indexed journals | Institutional |
 | PubMed | Email alert (My NCBI) | Biomedical literature | Free |
-| Semantic Scholar | Paper alert, author alert, topic feed | CS, biomedical, broad | Free |
+| OpenAlex | Work tracking, author profiles, concept feeds | All disciplines | Free |
 | ResearchGate | Author follow, recommendation | Member-uploaded papers | Free |
 
 ### Setting Up Google Scholar Alerts
@@ -76,7 +76,7 @@ def design_alert_system(research_topics: list[str],
             "frequency": "weekly"
         },
         "author_alerts": {
-            "platform": "Semantic Scholar + Scopus",
+            "platform": "OpenAlex + Scopus",
             "authors": key_authors,
             "frequency": "monthly"
         },

package/skills/literature/discovery/conference-proceedings-guide/SKILL.md

@@ -36,7 +36,7 @@ Strategy 1 - Search by conference name:
   DBLP: Browse conference page -> search within proceedings
 
 Strategy 2 - Search by topic across all venues:
-  Semantic Scholar: Filter by "Conference Paper" venue type
+  OpenAlex: Filter by type "proceedings-article"
   Google Scholar: Use keywords, then check venue names in results
 
 Strategy 3 - Track specific conferences:
@@ -101,7 +101,7 @@ Tiers vary by subfield. Always check the ranking relevant to your specific area.
 3. OpenReview: NeurIPS, ICLR, and others host papers with reviews
 4. Institutional repository: Check the authors' university repository
 5. Conference website: Some conferences offer free proceedings
-6. Semantic Scholar: Aggregates PDFs from multiple open sources
+6. OpenAlex: Aggregates metadata and OA links from multiple sources
 ```
 
 ### Workshop Papers vs. Main Conference

package/skills/literature/discovery/literature-mapping-guide/SKILL.md

@@ -51,7 +51,7 @@ How to use:
 Litmaps (litmaps.com) creates dynamic, multi-seed citation maps that update as new papers are published.
 
 Workflow:
-1. Add one or more seed papers via DOI, title, or Semantic Scholar ID
+1. Add one or more seed papers via DOI, title, or OpenAlex ID
 2. The tool builds a citation graph showing how the papers are connected
 3. Add "discover" nodes to expand the map with algorithmically suggested papers
 4. Create "collections" to organize maps by topic

package/skills/literature/discovery/paper-recommendation-guide/SKILL.md

@@ -22,22 +22,16 @@ Whether you are entering a new field and need foundational papers, tracking the
 
 ## Algorithmic Recommendation Services
 
-### Semantic Scholar Recommendations
+### OpenAlex Related Works
 
-Semantic Scholar provides a free recommendation API that suggests papers based on a set of seed papers you provide:
+OpenAlex provides concept-based and citation-based discovery for 250M+ works across all disciplines:
 
 ```bash
-# Get recommendations based on positive and negative example papers
-curl -X POST "https://api.semanticscholar.org/recommendations/v1/papers/" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "positivePaperIds": ["CorpusId:12345", "CorpusId:67890"],
-    "negativePaperIds": ["CorpusId:11111"],
-    "fields": "title,authors,year,citationCount,url"
-  }'
+# Find works related to a specific paper via its concepts and citations
+curl "https://api.openalex.org/works?filter=cites:W2741809807&sort=cited_by_count:desc&per_page=10"
 ```
 
-The positive/negative seed approach lets you steer recommendations toward the specific intersection of topics you care about. Start with 3-5 highly relevant papers as positive seeds and 1-2 off-topic papers as negative seeds.
+Use OpenAlex's concept graph to find related work by browsing papers tagged with the same research concepts, or trace citation networks to find derivative and foundational papers.
 
 ### Connected Papers
 
@@ -70,7 +64,7 @@ Research Rabbit (researchrabbitapp.com) lets you build collections of papers and
 When algorithmic tools are insufficient, manual citation-based techniques remain powerful:
 
 ### Forward Citation Chaining
-Start with a foundational paper. Find all papers that cite it (using Google Scholar, Semantic Scholar, or Web of Science). Screen these citing papers by title and abstract to find relevant descendants. Repeat for the most important descendants.
+Start with a foundational paper. Find all papers that cite it (using Google Scholar, OpenAlex, or Web of Science). Screen these citing papers by title and abstract to find relevant descendants. Repeat for the most important descendants.
 
 ### Backward Citation Mining
 Read the reference list of a key paper. Identify and retrieve the most important cited works. This traces the intellectual lineage of ideas and helps you find the seminal papers in a subfield.
@@ -89,7 +83,7 @@ A sustainable paper discovery practice requires more than one-off searches. Buil
 
 1. **Check preprint alerts**: Review your arXiv, bioRxiv, or SSRN email alerts or RSS feeds (15 min).
 2. **Scan citation alerts**: Review Google Scholar citation alerts for new papers citing your key references (10 min).
-3. **Process recommendation queue**: Review suggestions from Semantic Scholar, Research Rabbit, or Connected Papers for any recently added seed papers (10 min).
+3. **Process recommendation queue**: Review suggestions from OpenAlex, Research Rabbit, or Connected Papers for any recently added seed papers (10 min).
 4. **Social signals**: Scan academic Twitter/Mastodon, relevant subreddits, or lab group Slack channels for shared papers (10 min).
 5. **Triage and queue**: Add promising papers to your "to read" queue with a priority tag (high/medium/low) and the reason you flagged them.
 
@@ -113,7 +107,7 @@ Finding papers outside your primary field is particularly challenging because yo
 
 ## References
 
-- Semantic Scholar API: https://api.semanticscholar.org
+- OpenAlex API: https://api.openalex.org
 - Connected Papers: https://www.connectedpapers.com
 - Research Rabbit: https://www.researchrabbitapp.com
 - Paper Recommendation: https://github.com/pengzhenghao/paper-recommendation

package/skills/literature/discovery/rss-paper-feeds/SKILL.md

@@ -95,34 +95,40 @@ Recommended: Set alerts for:
 - Key competitor or collaborator publications
 ```
 
-### Semantic Scholar Alerts API
+### OpenAlex Citation Tracking
 
 ```python
 import requests
 
-def setup_semantic_scholar_alert(paper_id: str, email: str) -> dict:
+def track_citations_openalex(work_id: str) -> dict:
     """
-    Monitor citations for a specific paper via Semantic Scholar.
+    Monitor citations for a specific paper via OpenAlex.
 
     Args:
-        paper_id: Semantic Scholar paper ID or DOI
-        email: Email for notifications
+        work_id: OpenAlex work ID (e.g., 'W2741809807') or DOI
     """
-    # Fetch current citation count for baseline
+    headers = {"User-Agent": "ResearchPlugins/1.0 (https://wentor.ai)"}
     response = requests.get(
-        f"https://api.semanticscholar.org/graph/v1/paper/{paper_id}",
-        params={'fields': 'title,citationCount,citations.title,citations.year'}
+        f"https://api.openalex.org/works/{work_id}",
+        headers=headers
     )
     data = response.json()
 
+    # Get recent citing works
+    citing_resp = requests.get(
+        "https://api.openalex.org/works",
+        params={"filter": f"cites:{work_id}", "sort": "publication_date:desc", "per_page": 10},
+        headers=headers
+    )
+    citing = citing_resp.json().get("results", [])
+
     return {
         'paper': data.get('title', ''),
-        'current_citations': data.get('citationCount', 0),
-        'recent_citations': [
-            c for c in data.get('citations', [])
-            if c.get('year', 0) >= datetime.now().year - 1
-        ][:10],
-        'alert_email': email,
+        'current_citations': data.get('cited_by_count', 0),
+        'recent_citing_works': [
+            {'title': c.get('title'), 'year': c.get('publication_year')}
+            for c in citing
+        ],
         'status': 'configured'
     }
 ```

package/skills/literature/discovery/semantic-paper-radar/SKILL.md

@@ -31,16 +31,16 @@ Key components:
 - **Vector database**: Stores and indexes embeddings for fast similarity search. Options include ChromaDB (local), Qdrant, Pinecone, or Weaviate.
 - **Similarity metric**: Cosine similarity is standard for comparing text embeddings.
 
-### Using Semantic Scholar's Embedding Search
+### Using OpenAlex's Search API
 
-Semantic Scholar provides pre-computed SPECTER embeddings for millions of papers. You can use their search API for semantic queries:
+OpenAlex indexes 250M+ works and supports search queries across all disciplines:
 
 ```bash
-# Semantic search via the Semantic Scholar API
-curl "https://api.semanticscholar.org/graph/v1/paper/search?query=attention+mechanisms+for+graph+neural+networks&fields=title,abstract,year,citationCount&limit=20"
+# Search works via the OpenAlex API
+curl "https://api.openalex.org/works?search=attention+mechanisms+for+graph+neural+networks&per_page=20"
 ```
 
-The search endpoint uses semantic matching, not just keyword matching. A query like "methods for handling missing values in longitudinal studies" will find papers about imputation techniques, dropout analysis, and panel data methods even if they do not use the phrase "missing values."
+The search endpoint uses relevance-ranked matching. Combine with concept filters and citation data for more targeted discovery. For true semantic matching, build a local embedding index (see below).
 
 ### Building a Personal Semantic Index
 
@@ -84,7 +84,7 @@ This local index lets you search across all papers you have collected using natu
 Use semantic search to expand your awareness beyond your current reading:
 
 1. **Seed**: Take the abstract of your current paper (or a paragraph describing your research question).
-2. **Search**: Run it as a semantic query against a large corpus (Semantic Scholar, OpenAlex, or your local index).
+2. **Search**: Run it as a semantic query against a large corpus (OpenAlex, CrossRef, or your local index).
 3. **Filter**: Remove papers you have already read. Sort by a combination of semantic similarity and recency.
 4. **Cluster**: Group the top 50 results into thematic clusters using k-means or HDBSCAN on their embeddings.
 5. **Explore clusters**: Each cluster represents a related subtopic. Read the most-cited paper in each cluster to understand the connection to your work.
@@ -103,7 +103,7 @@ Semantic search excels at finding papers from other fields that address similar
 Set up periodic semantic searches to detect new papers in your area:
 
 1. Define 3-5 "concept vectors" by encoding descriptions of your core research interests.
-2. Weekly, search against newly published papers (last 7 days) from arXiv or Semantic Scholar.
+2. Weekly, search against newly published papers (last 7 days) from arXiv or OpenAlex.
 3. Rank new papers by maximum similarity to any of your concept vectors.
 4. Papers above your similarity threshold enter your reading queue automatically.
 
@@ -137,7 +137,7 @@ Compare your research question against the semantic landscape of existing work.
 
 ## References
 
-- Semantic Scholar API: https://api.semanticscholar.org
+- OpenAlex API: https://api.openalex.org
 - SPECTER2 model: https://huggingface.co/allenai/specter2
 - ChromaDB: https://www.trychroma.com
 - ResearchGPT: https://github.com/mukulpatnaik/researchgpt