This val turns public stars into qualified leads for you - even for repos you don’t own.
Why not use GitHub's webhooks?
If you're only interested in getting notified about your own stargazers, you can set up a webhook in GitHub directly.
There are 2 major limitations to that:
You can't track repos you don't own
You can't backfill stargazers from the past - which are often incredibly valuable to startups trying to find qualified leads
What this val does
This val does 2 things for you:
1) Track competitors' stargazers
GitHub won’t let you set up webhooks for repos you don’t own, and the stargazers API lists results oldest -> newest (no starred_at sorting). That means you can’t easily pull just the most recent stargazers.
So instead, we:
Use blob storage to remember the last stargazer count
Calculate the last page of the stargazers list
Fetch only the most recent X users when the count changes
Poll updates every 15 minutes (you can change this interval)
2) Get stargazer emails
The GitHub stargazers API won’t give you email addresses. This val works around that by checking each stargazer’s past commits - commits are associated with an email address. This is technically public, but buried.