Import reference · reviewed September 12, 2026

Google Search Console backlink import guide

Prepare Google Search Console backlink rows for AgentLinkOps: source and target columns, a compatible CSV example, preview behavior and common mistakes.

Use the google_search_console adapter for a tabular file with source-page and target-page URLs. The fields below describe the implemented AgentLinkOps adapter. Check your actual headers before using a provider preset; exports can differ by report and version.

Columns this adapter recognizes

Representative compatible headers; aliases may also be supported.
Purpose	Header	Interpretation
source	`Linking page`	Required URL of the page containing the link
target	`Target page`	Required URL the link points to
last_seen	`Last crawled`	Optional provider observation timestamp

Search Console supplies a view of links known to Google, not a complete census of every backlink. Keep its report scope with the candidate records.

Keep the original export: the adapter retains at most 32 additional nonblank metric fields, limits their names to 64 characters and string values to 256 characters. The normalized record is not a lossless archive.

A small compatible CSV

This synthetic example shows the minimum page pair. The example domains are placeholders. Use a copy of your own file for a real preview.

Linking page,Target page
https://example.org/resources,https://example.com/guide

Download this sample CSV

Preview from an existing repository checkout

The development CLI requires access to the AgentLinkOps repository. There is no public package installation step here. Run mkdir -p examples from the repository root, save the sample as examples/google-search-console.csv, then preview it:

node cli/linktrail.mjs import examples/google-search-console.csv --target example.com --from google_search_console

The import command reads and validates the file. It reports accepted, rejected and duplicate rows; it does not write the local ledger, fetch the source pages or create a remote import run. Keep the preview result beside the original export, and resolve rejected rows before using the candidate list.

What to check before proceeding

Aggregated Site / Incoming links and Top linked pages / Incoming links tables are rejected because they do not identify a source-page and target-page pair. Start with a page-level file containing both URLs, or prepare those pairs explicitly from your evidence.

A Last crawled value is a provider timestamp. It is not proof that the source still contains the link now. This adapter has no default anchor or nofollow field to invent missing detail.

If you include a mapped link-attribute column, inspect empty cells. The current parser treats a blank Nofollow cell as false and a blank dofollow cell as false. Those defaults are not evidence from a current fetch; omit an unreliable flag column or normalize it deliberately.

Confirm that the target URLs match the intended site. A well-formed row for a different target is still outside that import scope. If a column is missing, use an explicit mapping to an existing column or prepare the required data; do not fill in an invented source page.

From an imported row to current evidence

Provider dates and flags describe the supplied data. They do not establish that the backlink is live now. Review the candidate, check the source page and preserve the check time before recording a confirmed placement. A failed request remains inconclusive until you have evidence of what the page contains.

Imports and selected candidate checks are available in the private pilot. Live supplier discovery and competitor-gap workflows are still in validation. A local preview alone does not approve or bind a frozen inventory for competitor comparison.