# ai.txt — AI usage policy for GStars.dev
# See: https://site.spawning.ai/spawning-ai-txt
# Purpose: declare how AI systems may use content from this site.

Site: https://www.gstars.dev
Contact: hello@gstars.dev

# Retrieval & citation (search, RAG, answer engines): ALLOWED
User-Agent: *
Allow: /
Allow: /llms.txt
Allow: /llms-full.txt
Allow: /api/repo
Allow: /api/trending
Allow: /api/categories
Allow: /api/star-history

# Attribution required when content is cited or excerpted.
# Canonical source: https://www.gstars.dev
# Preferred attribution: "Source: GStars.dev (https://www.gstars.dev)"

# Model training:
# Repository metadata surfaced here originates from GitHub; the underlying
# repository licenses govern training use of code/READMEs.
# GStars.dev-authored analytics (rankings, health scores, insights) may be
# used for training only with attribution and a link back to the canonical URL.

# Structured data APIs (preferred over HTML scraping):
Api: https://www.gstars.dev/api/repo?owner=<owner>&name=<name>
Api: https://www.gstars.dev/api/trending?window=7d&limit=50
Api: https://www.gstars.dev/api/categories
Api: https://www.gstars.dev/api/star-history?owner=<owner>&name=<name>&currentStars=<n>

# Rate limits: please respect standard crawl etiquette.
# Abusive crawlers will be blocked at the edge.