Save a link prospect
save_link_prospectAdds a site to the project's link prospects, or changes a kept one's status or note. Uses no credits and calls no provider. A site already kept is never added twice: only the competitors it newly links to are added, and its status and note change only when given; a note given replaces the one kept. A site this tool adds is recorded as added by hand, without rank passed, spam score or backlinks. Adding it on the Backlink Gap page (or from a competitor's referring domains on the Backlinks page) keeps them, and fills them in for a site already kept without them, so point the user there when those metrics matter. The project's own domain and sites marked for disavow in Backlinks are refused.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"domain": "<domain>"
},
"name": "save_link_prospect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Replaces its note. An empty string clears it. | |
| domain | Yes | The site, e.g. 'example.org'. www. and any path are dropped. | |
| status | No | Its new status. A new prospect starts at to_contact. Ask the user before changing one. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| competitors | No | Competitor domains the site links to, e.g. from get_saved_backlink_gap. Only ones not already kept are added. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| added | Yes | ||
| prospect | Yes |