feat(integrations): add Semrush

[waleedlatif1]

Summary

• Adds Semrush as an API-key block with 44 operations covering the SEO API end to end: overview (domain/subdomain/URL totals, history, all-database rollups), domain and subdomain organic/paid keywords, competitors, ad copies, ad history and PLA reports, URL reports, keyword research (overview, batch, difficulty, related, broad match, questions, organic/paid SERP results, ad history), Domain vs. Domain comparison, and backlinks (overview, backlinks, referring domains and IPs, TLD/country distribution, anchors, indexed pages, competitors)
• Reports come back as delimited CSV, so the shared decoder maps each header cell back to the export column it was requested as instead of reading by position — the API can return fewer columns than were asked for (phrase_these accepts Td and omits Trends), and Fk/Fp both render under the header label SERP Features
• A rejected request arrives as HTTP 200 with an ERROR nnn :: ... body, so the body is checked even on success; export_escape=1 is always set and the parser is quote-aware so titles, anchors, and ad copy containing the delimiter survive
• Row limits are clamped so a single step cannot pull an unbounded result into memory
• Every column, parameter, and response field traces to a verbatim example in the Semrush API reference — nothing inferred

Not included

• Trends, Projects (Site Audit, Position Tracking), and Listing Management are separate Semrush products with their own endpoints and subscriptions
• backlinks_matrix and backlinks_comparison take repeated array parameters that do not fit the shared request builder
• subdomain_organic_unique documents a response format inconsistent with every other report

Type of Change

• New feature (non-breaking change which adds functionality)

Testing

• 27 unit tests over the decoder, request building, and block/tool alignment, using the API reference examples verbatim as fixtures. Reverting the header-mapping fix turns 3 of them red, including one that decodes a report with a middle column removed
• One test walks all 44 registered tools and asserts every export column they request resolves; another asserts, per operation, that the block shows a field for exactly the params its tool declares and marks the required ones required
• `bun run type-check`, `bun run lint`, and `bun run check:audits` (33/33) pass

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Aug 25, 2026 6:16pm

[greptile-apps]

Greptile Summary

The PR adds a Semrush API-key integration with 44 SEO and backlink operations, shared CSV decoding, workflow block configuration, generated metadata, documentation, and deployment registration.

• Adds Semrush tool definitions and response mappings across domain, URL, keyword, comparison, and backlink reports.
• Registers the integration throughout block, tool, icon, documentation, and deployment catalogs.
• Adds fixtures covering request construction, CSV parsing, column omission, registry alignment, and block parameters.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains.

No blocking failure remains.

Important Files Changed

Filename	Overview
apps/sim/tools/semrush/utils.ts	Adds shared Semrush URL construction, bounded row limits, error handling, and header-aware delimited-report decoding.
apps/sim/blocks/blocks/semrush.ts	Defines the workflow-facing Semrush operation selector, credentials, conditional parameters, outputs, and tool access list.
apps/sim/tools/semrush/semrush.test.ts	Adds coverage for report decoding, request construction, registry completeness, and block-to-tool alignment.
apps/sim/tools/registry.ts	Registers the new Semrush operation set in the executable tool registry.
apps/docs/content/docs/en/integrations/semrush.mdx	Documents setup, supported operations, inputs, and structured outputs for the Semrush integration.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[Semrush workflow block] --> B[Selected Semrush tool]
  B --> C[Shared request builder]
  C --> D[Semrush Analytics API]
  D --> E[Delimited report decoder]
  E --> F[Structured workflow output]

Loading

_{Reviews (2): Last reviewed commit: "fix(integrations): address Semrush revie..." | Re-trigger Greptile}

[cubic-dev-ai]

All reported issues were addressed

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[waleedlatif1]

@greptile