[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [GitHub user repositories](https://spiral.ai/integrations/gemini/github-user-repositories)

# How to Use GitHub user repositories in Gemini

Fetch public repositories for a GitHub account, with descriptions, languages, stars, forks, topics, licenses, and timestamps. Use it to compare a creator's projects or build a repository inventory across multiple pages.

|  |  |
| --- | --- |
| Model | GitHub user 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 user repositories in Gemini

- Use GitHub user repositories for kentcdodds to find projects related to React testing. Show descriptions, languages, stars, and links, and explain each match.
- Use GitHub user repositories for sindresorhus and find the ten most starred original repositories after checking every page. Include descriptions, languages, and archive status.
- Use GitHub user repositories for antfu to find TypeScript tools. Show their topics, last push dates, and links, and put archived projects in a separate section.
- Use GitHub user repositories for addyosmani to find projects about web performance. Compare their descriptions, stars, forks, and reported licenses.
- Use GitHub user repositories for kentcdodds and summarize the public project collection by reported language. Count original repositories and forks separately.

## How to set up GitHub user repositories in Gemini

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

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

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

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini 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 user 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-user-repositories",
    "input": {
      "url": "https://github.com/kentcdodds"
    }
  }'
```

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

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

## GitHub user repositories tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | GitHub user URL, e.g. https://github.com/kentcdodds. |
| sort | created, updated, pushed, full_name | — | Sort by created, updated, pushed, or full_name. Defaults to updated. |
| type | owner, all, member | — | Repository type. Defaults to owner. GitHub also supports all and member. |
| cursor |  | — | Cursor from the previous response. Defaults to 1. |
| handle |  | — | GitHub username/handle of the user you want the repositories for |
| direction | asc, desc | — | Sort direction: ascending or descending. |

## What can you do with GitHub user repositories in Gemini?

Get a readable shortlist of a GitHub creator's public projects with links and reasons to investigate each one. Compare descriptions, languages, stars, forks, and archive status without manually opening every repository.

### Build a public project directory

Turn a creator's repository names, descriptions, URLs, languages, and topics into a searchable project directory.

### Find projects worth evaluating

Shortlist repositories by description and language, then compare stars, forks, archive status, and last push dates before choosing projects for closer review.

### Track repository interest

Compare saved star and fork counts across scheduled collections to calculate changes for specific public projects.

### Prepare a license review queue

Collect reported license names alongside repository links and flag projects without a reported license for manual review before reuse.

### Refresh technical reading lists

Find repositories whose descriptions or topics match a reading list, then use archive status and push dates to prioritize entries for editorial review.

### Summarize a project collection

Group an account's public repositories by reported language and topic to explain what kinds of tools and examples are available.

### Review an existing dependency shortlist

Match repository URLs from a shortlist against returned records and surface archive status, reported licenses, and push timestamps for review.

## Overview

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

## GitHub user repositories in other agents

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

## More Gemini guides

- [GitHub user pull requests](https://spiral.ai/integrations/gemini/github-user-pull-requests)
- [Mistral OCR 4.1](https://spiral.ai/integrations/gemini/mistral-ocr-4-1)
- [GitHub user profile](https://spiral.ai/integrations/gemini/github-user-profile)
- [Mistral OCR document extraction](https://spiral.ai/integrations/gemini/mistral-ocr-document-extraction)
- [GitHub user following](https://spiral.ai/integrations/gemini/github-user-following)
- [Mistral document OCR](https://spiral.ai/integrations/gemini/mistral-document-ocr)

## Questions about GitHub user repositories in Gemini

**Can Gemini use GitHub user repositories?**

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

**How much does GitHub user repositories cost in Gemini?**

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

**Do I need a ScrapeCreators account to use GitHub user repositories in Gemini?**

No. Spiral runs GitHub user 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 user repositories in Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while GitHub user repositories runs?**

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

**Does this include private GitHub repositories?**

No. The documented coverage is public repositories associated with the requested GitHub account.

**Can I treat one response as the complete repository list?**

The endpoint supports pagination, so a response can represent only part of the list. Retrieve subsequent pages before ranking projects or calculating repository totals.

**How fresh and complete is GitHub's language information?**

GitHub updates language statistics after changes are pushed to the default branch. Its Linguist detector works only for repositories with fewer than 100,000 files, which limits language analysis for larger repositories.

**What does archived status tell me?**

GitHub says archiving makes a repository read-only and indicates that it is no longer actively maintained. Use that status when separating projects for adoption from projects kept for reference.

**Are repository topics a complete classification?**

Repository administrators choose their topics, and GitHub allows at most 20 per repository. Topics are useful labels, but that limit and administrator choice make them unsuitable as an exhaustive description.

