[Integrations](https://spiral.ai/integrations) › [Notion](https://spiral.ai/integrations/notion) › [GitHub trending repositories](https://spiral.ai/integrations/notion/github-trending-repositories)

# How to Use GitHub trending repositories in Notion

Returns GitHub's Trending list with repository ranks, descriptions, URLs, languages, star and fork totals, and stars gained during the selected period. Use it to shortlist projects attracting attention for a technical digest or tool review.

|  |  |
| --- | --- |
| Model | GitHub trending repositories |
| Available through | ScrapeCreators |
| Category | Data |
| Price | $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GitHub trending repositories in Notion

- Every morning, use GitHub trending repositories to check today's Python list. Compare it with yesterday's saved results and report newly observed repositories with descriptions, links, and ranks.
- Every Monday, use GitHub trending repositories to summarize this week's Go projects. Include total stars, forks, and stars gained this week, and highlight descriptions mentioning infrastructure.
- Each weekday, use GitHub trending repositories to check today's TypeScript list. Report repositories whose displayed rank improved by at least five places since the previous saved result.
- Every Friday, use GitHub trending repositories to fetch this week's Rust list and compare it with the previous saved weekly result. Summarize which repositories appeared in both.
- Each morning, use GitHub trending repositories to check today's JavaScript projects. Create a briefing of returned repositories gaining at least 500 stars today, with descriptions and links.

## How to set up GitHub trending repositories in Notion

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Notion this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

4. **Run GitHub trending repositories in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds GitHub trending repositories, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run GitHub trending repositories**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/github-trending-repositories",
    "input": {
      "since": "daily"
    }
  }'
```

Then paste one of the prompts above: Notion finds GitHub trending repositories on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/notion

## GitHub trending repositories tools and prices

- [GitHub · Trending Repositories](https://spiral.ai/tools/scrapecreators/scrapecreators/github-trending-repositories) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| since | daily, weekly, monthly | — | Trending range: daily, weekly, or monthly. Defaults to daily. |
| language |  | — | Optional coding language, e.g. javascript, python, or go. |
| spoken_language_code |  | — | Optional spoken language code filter, e.g. en. |

## What can you do with GitHub trending repositories in Notion?

Produce a recurring briefing of newly observed GitHub Trending projects and changes in their displayed ranks. An agent running on a schedule can compare saved results and highlight repositories that keep appearing in the same language list.

### Developer newsletter shortlist

Turn trending Python or TypeScript repositories into a newsletter shortlist with project descriptions, links, ranks, and stars gained during the selected period.

### Tool evaluation queue

Find trending Go infrastructure tools or Python data tools from their returned descriptions. Create a review queue with repository links and popularity counts before evaluating the code separately.

### Repository appearance alerts

Compare successive Python Trending results and flag repositories appearing for the first time in your saved observations, including their current rank and description.

### Daily and weekly overlap report

Compare daily and weekly TypeScript Trending results by repository URL. Highlight projects appearing in both lists and show each list's rank and period star count separately.

### Engineering reading list

Select Rust or Go projects whose descriptions match the team's current interests. Produce a short reading list with links and a description-based reason to investigate each project.

### Public ecosystem research

Study which subjects recur in trending repository descriptions and compare their languages and popularity counts. For published research, follow GitHub's condition that resulting publications be open access.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Notion guides](https://spiral.ai/integrations/notion)

## GitHub trending repositories in other agents

- [Amp](https://spiral.ai/integrations/amp/github-trending-repositories)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/github-trending-repositories)
- [Claude](https://spiral.ai/integrations/claude-desktop/github-trending-repositories)
- [Claude Code](https://spiral.ai/integrations/claude-code/github-trending-repositories)
- [Cline](https://spiral.ai/integrations/cline/github-trending-repositories)
- [Codex](https://spiral.ai/integrations/codex/github-trending-repositories)
- [Cursor](https://spiral.ai/integrations/cursor/github-trending-repositories)
- [Devin](https://spiral.ai/integrations/devin/github-trending-repositories)
- [dots](https://spiral.ai/integrations/dots/github-trending-repositories)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/github-trending-repositories)
- [Gemini](https://spiral.ai/integrations/gemini/github-trending-repositories)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/github-trending-repositories)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/github-trending-repositories)
- [goose](https://spiral.ai/integrations/goose/github-trending-repositories)
- [Grok](https://spiral.ai/integrations/grok/github-trending-repositories)
- [Grok Build](https://spiral.ai/integrations/grok-build/github-trending-repositories)
- [Hermes](https://spiral.ai/integrations/hermes/github-trending-repositories)
- [Instinct](https://spiral.ai/integrations/instinct/github-trending-repositories)
- [Manus](https://spiral.ai/integrations/manus/github-trending-repositories)
- [Muse](https://spiral.ai/integrations/muse/github-trending-repositories)
- [Muse Code](https://spiral.ai/integrations/muse-code/github-trending-repositories)
- [n8n](https://spiral.ai/integrations/n8n/github-trending-repositories)
- [OpenClaw](https://spiral.ai/integrations/openclaw/github-trending-repositories)
- [opencode](https://spiral.ai/integrations/opencode/github-trending-repositories)
- [Perplexity](https://spiral.ai/integrations/perplexity/github-trending-repositories)
- [Raycast](https://spiral.ai/integrations/raycast/github-trending-repositories)
- [VS Code](https://spiral.ai/integrations/vscode/github-trending-repositories)
- [Windsurf](https://spiral.ai/integrations/windsurf/github-trending-repositories)
- [Zapier](https://spiral.ai/integrations/zapier/github-trending-repositories)

## More Notion guides

- [GitHub trending developer list](https://spiral.ai/integrations/notion/github-trending-developer-list)
- [GitHub user contributions](https://spiral.ai/integrations/notion/github-user-contributions)
- [GitHub contribution activity](https://spiral.ai/integrations/notion/github-contribution-activity)
- [GitHub user followers](https://spiral.ai/integrations/notion/github-user-followers)
- [GitHub Repository](https://spiral.ai/integrations/notion/github-repository)
- [GitHub user following](https://spiral.ai/integrations/notion/github-user-following)

## Questions about GitHub trending repositories in Notion

**Can Notion use GitHub trending repositories?**

Yes. Add Spiral to Notion as an MCP server, and Notion can find and run GitHub trending repositories like any built-in tool.

**How much does GitHub trending repositories cost in Notion?**

$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Notion plan is separate.

**Do I need a ScrapeCreators account to use GitHub trending repositories in Notion?**

No. Spiral runs GitHub trending repositories on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GitHub trending repositories in Notion?**

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while GitHub trending repositories runs?**

GitHub trending repositories runs in the background. Notion starts the run, checks on it and gives you the json when it's ready.

**Does GitHub Trending cover every GitHub repository?**

No. GitHub describes Trending as a place to browse popular repositories of the day, so use it for discovery rather than a complete repository inventory. ScrapeCreators retrieves publicly available information.

**How fresh is the GitHub Trending data?**

ScrapeCreators says it fetches the latest available information when you make a request. That describes retrieval freshness; it does not establish how often GitHub recalculates its rankings.

**Are total stars and stars gained separate measurements?**

Yes. The documented response separates total stars, total forks, and stars gained during the trending period, including a label such as stars today. Keep those measurements separate when comparing projects.

**Does ScrapeCreators guarantee the counts are accurate?**

No. Its terms explicitly decline to guarantee data accuracy or availability, including information retrieved from external websites.

**Can I reuse code from any publicly listed repository?**

Public visibility alone does not grant unrestricted code reuse. GitHub says default copyright restrictions apply when a repository has no license, including restrictions on reproduction, distribution, and derivative works.

