Before you start
Owner access to your website’s Search Console property. You can reuse the service account from Sprid’s Play connection.
Set it up
A. Google Cloud
- Open Google Cloud and select your service account’s project.
- APIs & Services → Library: enable Google Search Console API.
- No service account yet? IAM & Admin → Service Accounts → Create service account, name it
sprid-gsc, then Done. - Open the account → Keys → Add key → Create new key → JSON. Save it as
gsc-sa.jsonand copy the account’s email. Reusing an account? Use its existing key file and email.
B. Search Console
- Open Search Console and select your website in the top-left dropdown.
- Settings → Users and permissions → Add user.
- Enter the service account’s email, choose Restricted, then Add.
Domain property vs URL prefix, and the property string
| Property shown in Search Console | Value to use |
|---|---|
Domain, such as example.com | sc-domain:example.com |
URL prefix, such as https://www.example.com/ | The exact URL, including its final slash |
A domain property covers every version of your domain. Settings → Property settings shows which kind you have.
Connect to Sprid
sprid connect gsc --key ~/Downloads/gsc-sa.json --property sc-domain:example.comUse your own file path and property. Keep the file private.
Check the connection
Run sprid status, then ask your agent: “Read recent Google search results for this website through Sprid and check that the property is correct.” A saved key confirms setup; only the live read confirms access. The newest few days may be missing because Google reports late.
If something goes wrong
- Access denied: check the service account’s email was added to the exact property in your command. If both match, try Full permission. Do not grant Owner.
- Property not found: check the domain or URL, including
www,httpsand the final slash. - Recent dates are empty: try an earlier period; the latest days may still be processing.
Investigate with this connection
Reads search for the pinned property. Dates are Pacific time; anonymized queries and top-row limits reduce coverage.
sprid marketing-review capabilities --app <slug> --source gsc --jsonSee connected queries.
Sources and verification
Prefer your terminal? sprid docs search-console reads this same guide.