| name | julien-notion-github-enhance |
| description | Enrich a Github [DB] entry with GitHub API metadata (description, stars, language, cover image). Use when user wants to populate a GitHub repo entry with live metadata, enhance github entry, or add github info. |
Notion GitHub Enhance
Enrich Github [DB] entries with live metadata from GitHub API.
Prerequisites
NOTION_TOKENenvironment variable setGITHUB_TOKENenvironment variable (optional, for higher rate limits)requestspackage:pip install requests
Usage
Run the enrichment script with a page ID or URL:
python ~/.claude/skills/notion-github-enhance-note/scripts/enrich.py <page_id_or_url>
Arguments:
page_id_or_url: Notion page ID (UUID) or full URL of Github [DB] entry
Example:
python ~/.claude/skills/notion-github-enhance-note/scripts/enrich.py 12345678-1234-1234-1234-123456789abc
Output
- On success: Confirmation with updated fields
- On failure: Error message with reason
Data Retrieved
| Field | Source | Notes |
|---|---|---|
| Description | GitHub API | Repo description |
| Language | GitHub API | Primary language |
| Stars | GitHub API | Star count |
| Cover | OpenGraph | Social preview image |
Rate Limits
- Without GITHUB_TOKEN: 60 requests/hour
- With GITHUB_TOKEN: 5000 requests/hour
Set GITHUB_TOKEN environment variable for higher limits:
export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
Error Handling
| Error | Meaning |
|---|---|
NOT_REPO_URL |
URL is org page or not a valid repo |
REPO_NOT_FOUND |
Repository deleted or private |
RATE_LIMITED |
GitHub API rate limit reached |
PAGE_NOT_FOUND |
Invalid page ID or no access |
Database ID
- Github [DB]:
2cacdc04-12e3-81cc-a84e-fdbba086ab29