[Integrations](https://spiral.ai/integrations) › [Factory Droid](https://spiral.ai/integrations/factory-droid) › [GitHub trending repositories](https://spiral.ai/integrations/factory-droid/github-trending-repositories)

# How to Use GitHub trending repositories in Factory Droid

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 Factory Droid

- Use GitHub trending repositories to fetch today's TypeScript results, compare their names with package.json, and write a Markdown review shortlist with descriptions, URLs, ranks, and star counts.
- Use GitHub trending repositories to fetch this week's Python results and create a CSV containing repository names, URLs, descriptions, total stars, forks, and stars gained during the week.
- Use GitHub trending repositories to compare today's and this week's Go results. Write a report of repositories appearing in both, preserving their rank and star counts for each period.
- Use GitHub trending repositories to fetch today's Rust results and compare their descriptions with this project's README. Save a shortlist of relevant projects with links and a reason to review each.
- Use GitHub trending repositories to fetch today's Python results and compare repository URLs with our saved discovery report. Report newly observed projects with their current rank and description.

## How to set up GitHub trending repositories in Factory Droid

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

### Use Spiral's MCP server

1. **Add the server**: Droid saves it to your user config, `~/.factory/mcp.json`, so it works in every project.

```bash
droid mcp add spiral https://api.spiral.ai/mcp --type http
```

2. **Sign in**: Start `droid`, type `/mcp`, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

3. **Check it**: Spiral shows as connected. needs authentication means the sign-in did not finish: run `/mcp` again.

```bash
droid mcp list
```

### Use the Spiral skill

1. **Send Factory Droid 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 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: Factory Droid finds GitHub trending repositories on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/factory-droid

## 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 Factory Droid?

Build a repository discovery report using GitHub Trending ranks, descriptions, links, and popularity counts. A coding agent can compare those results with your project's dependencies and create a focused queue for technical review.

### 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 Factory Droid guides](https://spiral.ai/integrations/factory-droid)

## 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)
- [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)
- [Notion](https://spiral.ai/integrations/notion/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 Factory Droid guides

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

## Questions about GitHub trending repositories in Factory Droid

**Can Factory Droid use GitHub trending repositories?**

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

**How much does GitHub trending repositories cost in Factory Droid?**

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

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

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 Factory Droid?**

About two minutes: add the server, then sign in, then check it.

**Does Factory Droid wait while GitHub trending repositories runs?**

GitHub trending repositories runs in the background. Factory Droid 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.

