feat: add Semrush SEO subagent (t087)

[marcusquinn]

Summary

• Add Semrush Analytics API v3 subagent (seo/semrush.md) with curl-based integration for domain analytics, keyword research, backlink analysis, competitor research, and position tracking
• Document pricing tiers (unit-based system), all major API endpoints with working curl examples, column codes, and filter syntax
• Update seo.md main agent with Semrush references in subagent list, API access table, and tool comparison matrix
• Update subagent-index.toon with semrush key file entry

Task

Closes t087 - Create Semrush subagent

Changes

File	Change
.agent/seo/semrush.md	New subagent with 15+ API endpoint examples, pricing docs, column reference, filter syntax, Ahrefs comparison
.agent/seo.md	Added semrush to subagents list, tools list, subagent table, API access table, and expanded tool comparison
.agent/subagent-index.toon	Added semrush to seo/ key_files
TODO.md	Marked t087 complete

Summary by CodeRabbit

Release Notes

• New Features
  • Added Semrush as a new SEO subagent, expanding analytics capabilities with domain overview, keyword research, backlinks tracking, on-page analysis, and competitor analysis features.

[gemini-code-assist]

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

[coderabbitai]

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 25 minutes and 48 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

Introduces Semrush as a new SEO subagent by adding it to the SEO agent configuration, creating comprehensive integration documentation, updating the tool comparison table, and marking the implementation task as complete.

Changes

Cohort / File(s)	Summary
SEO Agent Configuration .agent/seo.md, .agent/subagent-index.toon	Added Semrush to the SEO subagents list, API access section, and expanded the tool comparison table with Semrush column. Updated subagent index key_files dependency list to include semrush alongside existing SEO tools.
Semrush Documentation .agent/seo/semrush.md	New comprehensive integration guide covering Semrush REST APIs v3, authentication via SEMRUSH_API_KEY, endpoint usage with curl examples, pricing/unit management, setup instructions, parameter reference, and comparison with Ahrefs.
Task Completion TODO.md	Updated Semrush subagent task (t087) status from pending to completed with timestamp 2026-02-06.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• feat: add NeuronWriter content optimization API subagent #231: Adds NeuronWriter SEO subagent following the same integration pattern (documentation file, agent configuration updates, subagent index modifications).
• feat(agents): add subagent filtering via frontmatter #75: Extends the SEO subagent framework structure by introducing Semrush as an additional tool in the established configuration hierarchy.

Poem

🔍 Semrush enters the SEO quest,
With APIs and docs, among the best,
Rankings tracked with expert care,
Zero debt in every layer! 📊✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely summarizes the main change: adding a Semrush SEO subagent. It is specific, references the task identifier, and directly matches the primary objectives of the pull request.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/t087

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 23 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Fri Feb 6 16:53:47 UTC 2026: Code review monitoring started
Fri Feb 6 16:53:48 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 23
Fri Feb 6 16:53:48 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Fri Feb 6 16:53:50 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 23
• VULNERABILITIES: 0

Generated on: Fri Feb 6 16:53:52 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud