[Integrations](https://spiral.ai/integrations) › [Amp](https://spiral.ai/integrations/amp) › [GitHub Repository](https://spiral.ai/integrations/amp/github-repository)

# How to Use GitHub Repository in Amp

Get one public GitHub repository’s description, language, stars, forks, license, archive status, and timestamps. Use it to compare known projects, enrich a software catalog, or check a dependency’s upstream status.

|  |  |
| --- | --- |
| Model | GitHub Repository |
| 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 Repository in Amp

- Use GitHub repository details for https://github.com/microsoft/TypeScript and compare its reported license and archive status with the TypeScript entry in this project’s dependency inventory.
- Use GitHub repository details for https://github.com/vitejs/vite and https://github.com/webpack/webpack, then add a comparison of their descriptions, languages, stars, forks, and archive status to docs/build-tools.md.
- Use GitHub repository details for https://github.com/vercel/next.js and update our software catalog entry with its description, homepage, topics, and default branch.
- Use GitHub repository details for https://github.com/expressjs/express and add its reported license, archive status, and push timestamp to our dependency review notes.
- Use GitHub repository details for https://github.com/astral-sh/ruff and save its stars and forks as the first observation in this project’s repository metrics dataset.

## How to set up GitHub Repository in Amp

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

### Use Spiral's MCP server

1. **Add the server**: No header and no client ID or secret: Amp registers itself with Spiral.

```bash
amp mcp add spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `amp`. Amp opens Spiral's sign-in page in your browser: sign in, pick the organization and click Authorize. No API key.

3. **Check it**

```bash
amp mcp doctor
```

### Use the Spiral skill

1. **Send Amp 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 Repository**: 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-repository",
    "input": {
      "url": "https://github.com/torvalds/linux"
    }
  }'
```

Then paste one of the prompts above: Amp finds GitHub Repository on Spiral, shows the price and runs it.

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

## GitHub Repository tools and prices

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

## What can you do with GitHub Repository in Amp?

Build a dependency review table from public GitHub repository metadata and your project’s dependency files. A coding agent can match known upstream repositories to local packages, then highlight archive status, reported licenses, and default branches for review.

### Compare a software shortlist

Compare known repositories by description, language, topics, stars, forks, and archive status before choosing which projects to investigate further.

### Review upstream dependency status

Check the public repositories behind your dependencies for archive status, default branch, and push timestamps to prioritize maintenance reviews.

### Refresh a software catalog

Update catalog entries with repository descriptions, homepages, languages, topics, and links for a known list of projects.

### Prepare a license review queue

Collect reported license names and identifiers for candidate dependencies, then route unclear entries for review before code reuse.

### Measure changes in project interest

Collect repeated star and fork totals for selected repositories and calculate changes between your saved observations.

### Prepare a project research brief

Summarize a repository’s stated purpose, language, topics, license, archive status, and popularity counts for an engineering evaluation.

### Detect repository metadata changes

Compare successive observations of a known repository’s description, homepage, default branch, license, and archive status to flag changes for review.

## Overview

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

## GitHub Repository in other agents

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

## More Amp guides

- [Gemini content classification](https://spiral.ai/integrations/amp/gemini-content-classification)
- [GitHub contribution activity](https://spiral.ai/integrations/amp/github-contribution-activity)
- [Firecrawl research paper metadata and passages](https://spiral.ai/integrations/amp/firecrawl-research-paper-metadata-and-passages)
- [GitHub trending developer list](https://spiral.ai/integrations/amp/github-trending-developer-list)
- [Firecrawl related research papers](https://spiral.ai/integrations/amp/firecrawl-related-research-papers)
- [GitHub trending repositories](https://spiral.ai/integrations/amp/github-trending-repositories)

## Questions about GitHub Repository in Amp

**Can Amp use GitHub Repository?**

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

**How much does GitHub Repository cost in Amp?**

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

**Do I need a ScrapeCreators account to use GitHub Repository in Amp?**

No. Spiral runs GitHub Repository 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 Repository in Amp?**

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

**Does Amp wait while GitHub Repository runs?**

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

**Does this cover private repositories or return multiple projects?**

GitHub repository details covers one public repository per call. Its documented output is repository metadata, so a comparison of five known projects requires five repository lookups.

**How fresh is the data, and can I get historical star counts?**

ScrapeCreators describes its extraction as real time. The documented repository response contains one set of totals plus creation, update, and push timestamps; build star-growth comparisons from snapshots you collect over time.

**Do stars and watchers measure the same thing?**

GitHub describes stars as an approximate measure of interest. In its REST responses, watchers_count also counts stars, while subscribers_count counts watchers, so do not interpret the returned watchers count as a separate audience.

**What does an archived repository mean?**

GitHub uses archiving to make a repository read-only and indicate that it is no longer actively maintained. A repository can later be unarchived, so archive status is useful to check repeatedly when reviewing dependencies.

**Does a public repository mean its code is free to reuse?**

Public visibility alone does not grant unrestricted reuse rights. GitHub says default copyright rules apply without a license; use the returned license metadata to identify projects that need a closer license review.

