Import reference · reviewed September 12, 2026

Majestic backlink import guide

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

Use the majestic 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	`SourceURL`	Required URL of the page containing the link
target	`TargetURL`	Required URL the link points to
anchor	`AnchorText`	Optional supplier-reported anchor text
first_seen	`FirstIndexedDate`	Optional provider first-seen timestamp
last_seen	`LastSeenDate`	Optional provider observation timestamp
link attribute	`FlagNoFollow`	Optional supplier flag; inspect its meaning before use

Trust Flow and Citation Flow, if present, stay in the supplier data. They are not an observed property of the link fetched today.

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 and an optional anchor. The example domains are placeholders. Use a copy of your own file for a real preview.

SourceURL,TargetURL,AnchorText
https://example.org/resources,https://example.com/guide,Example resource

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/majestic.csv, then preview it:

node cli/linktrail.mjs import examples/majestic.csv --target example.com --from majestic

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

Keep the index or export context with the file. A historical row is a research clue and still needs a current page check before you call the link live.

The adapter recognizes compact labels such as SourceURL and AnchorText. Date can be a fallback for date mapping, so inspect files with a generic Date column before interpreting it as a particular observation.

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.