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

# How to Use GitHub user repositories in Hermes

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 Hermes

- Every Monday, use GitHub user repositories for kentcdodds and compare every page with the previous collection. Summarize newly observed repositories with descriptions and links.
- Each day, use GitHub user repositories for sindresorhus and compare star counts with yesterday's saved results. Report the five largest increases among repositories present in both collections.
- Every Friday, use GitHub user repositories for antfu and report repositories whose last push date changed since the previous check. Include language, topics, and links.
- Each week, use GitHub user repositories for addyosmani and report changes in archive status or reported license. Show the previous and current values beside each repository link.
- Each month, use GitHub user repositories for kentcdodds and compare star and fork counts with the previous collection. Summarize the changes for original repositories separately from forks.

## How to set up GitHub user repositories in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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: Hermes finds GitHub user repositories on Spiral, shows the price and runs it.

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

## 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 Hermes?

Produce a recurring digest of changes to public GitHub projects. Compare saved collections to report star and fork count changes, archive status changes, and newly observed repository records.

### 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 Hermes guides](https://spiral.ai/integrations/hermes)

## 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](https://spiral.ai/integrations/gemini/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)
- [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 Hermes guides

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

## Questions about GitHub user repositories in Hermes

**Can Hermes use GitHub user repositories?**

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

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

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

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

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 Hermes?**

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

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

GitHub user repositories runs in the background. Hermes 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.

