How to Use GitHub Repository in Grok
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.
Prompts to try with GitHub Repository in Grok
Copy an example into Grok, or ask in your own words.
Use GitHub repository details for https://github.com/vitejs/vite and https://github.com/webpack/webpack. Compare their stated purposes, languages, stars, forks, and archive status.
Use GitHub repository details for https://github.com/microsoft/TypeScript. Give me a short brief with its description, homepage, topics, reported license, and last push time.
Use GitHub repository details for https://github.com/pallets/flask and https://github.com/django/django. Make a table of their descriptions, reported licenses, stars, forks, and archive status.
Use GitHub repository details for https://github.com/astral-sh/ruff. Show its language, default branch, reported license, stars, and forks.
Use GitHub repository details for https://github.com/facebook/react and https://github.com/vuejs/core. Compare their topics and descriptions, then show their stars and forks as separate measures.
How to set up GitHub Repository in Grok
Pick the way that suits you. Each takes about two minutes.
Use the Grok connector
- Add a custom connector
In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.
- Check that it is connected
Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.
Use the Spiral skill
- Send Grok this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run GitHub Repository
One request; the result comes back by polling or a webhook.
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: Grok finds GitHub Repository on Spiral, shows the price and runs it.
GitHub Repository providers and prices
Spiral runs GitHub Repository through ScrapeCreators. Open a card for today's price, with every fee included.
What can you do with GitHub Repository in Grok?
Turn a shortlist of GitHub projects into a comparison you can read without inspecting each repository page. A chat app can organize descriptions, languages, stars, forks, reported licenses, and archive status into a focused research brief.
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.
More on GitHub Repository and Grok
Overview
GitHub Repository in other agents
Questions about GitHub Repository in Grok
Can Grok use GitHub Repository?
Yes. Add Spiral to Grok as an MCP server, and Grok can find and run GitHub Repository like any built-in tool.
How much does GitHub Repository cost in Grok?
$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Grok plan is separate.
Do I need a ScrapeCreators account to use GitHub Repository in Grok?
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 Grok?
About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.
Does Grok wait while GitHub Repository runs?
GitHub Repository runs in the background. Grok 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.
Start using GitHub Repository in Grok
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Grok:
set up https://spiral.ai/SKILL.md


