AI Agent · 42 tools · Open Source
SEO Agent
A fully autonomous SEO agent that audits your site, tracks keywords, optimizes content, monitors competitors, and fixes issues by opening GitHub PRs — all without human intervention. Runs daily, weekly, and monthly on cron. Reports everything via Discord.
Capabilities
What it does for you
Full technical audit in minutes
Meta tags, headings, schema, Core Web Vitals, security headers, hreflang, sitemap validation — the agent runs a comprehensive audit across your entire site autonomously.
Content strategy on autopilot
Keyword research, content gap analysis, topic cluster mapping, content decay detection, and content calendar planning. The agent identifies opportunities you'd miss manually.
Automated fixes via GitHub PRs
When the agent finds fixable issues — missing alt texts, broken schema, thin content — it generates the code fix and opens a pull request. You just review and merge.
Competitor intelligence
Monitors competitor sites for changes, tracks their content strategy, scrapes sitemaps, and analyzes SERP positioning. Weekly digest delivered to Discord.
Link building at scale
Deep backlink analysis, high-value target identification, unlinked mention detection, and personalized outreach email drafting. Everything except pressing send.
Reports & closed-loop feedback
Structured Markdown audit reports, visual dashboards, and Discord notifications. Tracks every recommendation and measures impact over time. Daily keyword alerts, weekly full audits, monthly strategic reviews.
Architecture
How it works
Next.js App
Chat UI
useChat
/api/chat
Route Handler
ToolLoopAgent
Claude Sonnet 4
Vercel Workflow
Durable execution
GSC
5 tools
Audit
4 tools
Content
5 tools
Monitor
3 tools
Actions
9 tools
Google APIs
Target Website
Vercel AI Gateway
Competitor Sites
GitHub + Discord
The agent uses Vercel AI SDK’s ToolLoopAgent pattern. Given a prompt, the LLM autonomously decides which tools to call and in what order. A full audit triggers all 42 tools. A focused check runs only the relevant subset.
Two-model strategy: Gemini 2.5 Pro handles heavy analysis (content audits, competitor deep-dives) while Gemini 2.5 Flash runs lighter tasks at lower cost.
42 Tools
Complete tool inventory
Google Search Console (4)
querySearchConsoleQuery GSC for keywords, pages, and performance datainspectUrlCheck indexing status and crawl info for any URLcheckSitemapStatusVerify sitemap submission and coveragequeryBacklinksAnalyze external links pointing to the domainPerformance (1)
measureCoreWebVitalsMeasure LCP, FID, CLS, TTFB via PageSpeed InsightsAudit (4)
deepAuditPageFull page audit — meta, headings, images, schema, links, contentcrawlSiteDiscover all pages via sitemap.xml or HTML crawlauditSecurityHeadersCheck HTTPS, CSP, HSTS, and security headerscrossPageHreflangAuditValidate hreflang implementation across localesAnalysis (6)
detectCannibalizationFind pages competing for the same keywordsanalyzeContentGapsIdentify missing topics vs. competitorsanalyzeCompetitorSERPAnalyze top SERP results for target keywordsresearchKeywordsFind keyword opportunities with volume and difficultydetectContentDecayIdentify pages losing traffic over timeidentifyContentToPruneFlag thin or underperforming content for removalContent Optimization (5)
optimizePageContentAI-powered content improvement suggestionsgenerateMissingContentDraft content for identified gapssuggestInternalLinksFind internal linking opportunitiesplanContentCreate content calendar based on keyword researchoptimizeForSERPFeaturesOptimize for featured snippets and rich resultsQuality & E-E-A-T (2)
auditEEATEvaluate Experience, Expertise, Authority, Trust signalsgenerateAltTextsGenerate SEO-optimized alt text for imagesMonitoring (3)
monitorCompetitorChangesTrack competitor site changes and new contenttrendingTopicsIdentify trending topics in the industryscrapeCompetitorSitemapsMap competitor site structure and contentOff-page & Link Building (4)
deepBacklinkAnalysisAnalyze backlink profile quality and distributionfindLinkBuildingTargetsIdentify high-value link building opportunitiesfindUnlinkedMentionsFind brand mentions without backlinksdraftOutreachGenerate personalized outreach emails for link buildingStrategy (1)
buildTopicClusterMapCreate pillar-cluster content strategyAnalytics (1)
queryAnalyticsQuery GA4 for traffic, conversions, and user behaviorExecution & Actions (5)
generateCodeFixGenerate code fixes for technical SEO issuescreateGitHubPRCreate pull requests with automated fixeswriteReportGenerate structured Markdown audit reportsgenerateDashboardCreate visual SEO performance dashboardsautoRefreshDecayingContentAutomatically update declining contentNotifications & Verification (2)
notifyTeamSend alerts and reports via Discord webhooksverifyDeployedFixVerify that deployed fixes actually workFeedback & Tracking (4)
readRepoContextRead repository context for informed decisionssubmitToIndexingSubmit URLs to Google for indexingtrackRecommendationsTrack past recommendations and measure their impactmanageActionsManage and prioritize action items across auditsAutonomous Workflow
Runs on cron, reports via Discord
Daily · 6:00 UTC
Keyword Monitoring
Weekly · Monday 8:00 UTC
Full Audit + Auto-Fix
Monthly · 1st, 9:00 UTC
Strategic Review
Bi-monthly · 1st & 22nd, 8:00 UTC
Deploy Verification
Discord Integration
SEO Agent
Weekly Audit Report — cyrcid.com
Score: 72/100 | 3 critical | 8 warnings | 2 PRs created
Critical: Missing meta descriptions on /en/pricing, /en/features
Fixed: Alt texts added (PR #47), schema markup updated (PR #48)
Action needed: "digital product passport" — 0 impressions, content too thin
Get Started
Deploy your own in 5 steps
The full source code is on GitHub. Clone it, add your API keys, deploy to Vercel, and you have a production SEO agent running on your domain.