Connect Codex to Semrush
Give your Codex agent access to Semrush in Melso — 37 tools it can call while it works through a task.
Set it up in Melso
- 1In Melso, open Settings → Agent Apps and hit Connect on Semrush.
- 2Finish the API_KEY sign-in in the window that opens. Melso stores the connection, not your credentials.
- 3Open your Codex agent, go to its Agent Apps tab, and allow Semrush.
- 4Give the agent a task. It calls Semrush itself when the work needs it.
What Semrush gives your agent
The tools, permissions, and events Semrush exposes — the same ones your agent can use once the app is authorized.
What you sign in with
Semrush connects with API_KEY.
Permissions
Semrush does not break access down into granular permissions.
Tools Semrush exposes
Check Semrush account units balance
Tool to fetch the remaining Semrush Standard API units for the authenticated account. Use this before launching large batches of Semrush report requests to preflight and fail fast if units are exhausted or below a required threshold.
Get ad copies
Retrieves unique ad copies Semrush has observed for a specified domain from a regional database, detailing ads seen in Google's paid search results. Results are a sampled subset, not a complete picture of the domain's advertising. Response is returned as a CSV-like string; parse columns (e.g., Tt, Ds) using the pipe or semicolon delimiter.
Get anchor texts
Use this action to get a CSV report of anchor texts for backlinks pointing to a specified, publicly accessible domain, root domain, or URL.
Get authority score profile
Retrieves the Authority Score (AS) profile for a specified target, showing the count of referring domains that link to the target for each AS value from 0 to 100.
Get backlinks
Fetches backlinks for a specified domain or URL as a semicolon-delimited CSV string (parse with `sep=';'`); allows customization of columns, sorting, and filtering. Consumes Semrush API credits per request. Ensure `display_limit` surpasses `display_offset` when an offset is used, and note the `urlanchor` filter may have limitations for targets with extensive backlinks.
Backlinks overview
Provides a semicolon-delimited (sep=';') CSV summary of backlinks, including Authority Score and link type breakdowns, for a specified and publicly accessible domain, root domain, or URL. A result of 'ERROR 50 :: NOTHING FOUND' means the target has no data in the database and is a valid zero-result response.
Batch comparison
Compares backlink profiles for multiple specified targets (domains, subdomains, or URLs) to analyze and compare link-building efforts.
Batch keyword overview
Fetches a keyword overview report from a Semrush regional database for up to 100 keywords, providing metrics like search volume, CPC, and keyword difficulty. Response is CSV-like text (not JSON); parse accordingly. Returns literal string 'ERROR 50 :: NOTHING FOUND' for keywords with no data in the selected database — treat as zero results and fall back to SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE or SEMRUSH_KEYWORD_OVERVIEW_ALL_DATABASES for those terms.