track_gsc_property

Cost: Free (0 credits).

track_gsc_property turns a Search Console property into a tracked project in one call. It works out the site's domain from the property, opens the project for it — or brings it back from your archive — and links the property to it, ready for pull_gsc_data.

What it does

Pass a property exactly as list_gsc_properties prints it. SeoGrep re-reads your Google accounts live and only accepts a property one of them actually lists — what you type is never taken as proof it exists. If you already have a project for that domain, it is reused rather than duplicated, so running this twice is safe. If the same property sits on two of your connected accounts, SeoGrep asks which one to read it through instead of guessing, and you re-run with account_id.

When it refuses

A property your account cannot query is refused before any project is created — a project that looks tracked but can answer nothing is worse than no project, so the answer names the permission level and what to do about it. A property no connected account lists is refused the same way. And if Google could not be reached at all, you are told the account could not be read, never that the property is missing: an absence we did not observe is not an absence.

The same rule applies when only some of your accounts answer. If the property is listed on an account that answered while another account could not be read, SeoGrep refuses rather than binding: the silent account might list it too, and a passing outage must not decide which Google account a project reads through. Re-run with account_id to settle it yourself, or try again once the other account is readable.

Archived projects

If you archived the project for this domain earlier, this brings back the same project — its id, its crawls and its reports are all still there. Nothing is started from scratch and no second project is created for the same site.

Example

Ask your MCP client in plain language:

Track sc-domain:example.com in SeoGrep.

Run list_gsc_properties first if you are not sure how a property is spelled.

Input

Returns

The project the property was attached to — its domain and project_id, whether it was created, already tracked or restored from your archive, which Google account it now reads through, and the tools to run next.