What This Agent Does
This SEO Analysis Agent automatically analyzes webpages for search engine optimization opportunities on a scheduled basis. It fetches URLs from a Google Sheet, extracts page content, performs comprehensive SEO analysis using AI, and delivers actionable insights directly to your team via Telegram notifications while storing results back in your sheet.
This workflow saves your team hours of manual SEO auditing by automating the entire analysis pipeline. Instead of manually visiting each webpage and checking SEO metrics, your agent works 24/7 to monitor your content performance, identify optimization opportunities, and keep everyone informed in real-time. Perfect for content teams, digital marketers, and agencies managing multiple websites or blog posts.
Key benefits:
-
Automated monitoring of SEO performance across multiple URLs
-
Consistent analysis using the same AI-powered criteria every time
-
Real-time notifications keep your team aligned on optimization needs
-
Centralized reporting with results automatically saved to your sheet
-
Scalable solution that grows with your content library
Target use cases:
- Blog networks requiring regular SEO audits
- E-commerce sites monitoring product page optimization
- Agency clients needing periodic SEO health checks
- Content marketing teams tracking keyword optimization
- Multi-site publishers ensuring consistent SEO standards
Who Is It For
This agent is ideal for:
-
Content Marketing Teams who need regular SEO audits without manual effort
-
Digital Marketing Agencies managing SEO for multiple client websites
-
E-commerce Managers optimizing product and category pages
-
Blog Publishers ensuring consistent SEO quality across articles
-
SEO Specialists who want to automate routine analysis tasks
-
Business Owners wanting to monitor their website's SEO health automatically
No coding experience required—TaskAGI handles all the technical complexity while you focus on implementing the insights.
Required Integrations
Google Sheets
Why it's needed: Google Sheets serves as your data source and destination. It stores the URLs you want to analyze and receives the SEO analysis results, creating a centralized hub for your SEO data.
Setup steps:
- Open your Google account and navigate to Google Cloud Console
- Create a new project (or select an existing one)
- Enable the Google Sheets API:
- Click "Enable APIs and Services"
- Search for "Google Sheets API"
- Click "Enable"
- Create a Service Account:
- Go to "Credentials" in the left menu
- Click "Create Credentials" → "Service Account"
- Fill in the service account name and click "Create and Continue"
- Grant the "Editor" role and click "Continue"
- Create a JSON key:
- Click on the service account you just created
- Go to the "Keys" tab
- Click "Add Key" → "Create new key"
- Choose "JSON" and click "Create"
- Save the downloaded JSON file securely
How to obtain credentials:
The JSON file you downloaded contains your client_email and private_key. You'll use these to authenticate with TaskAGI.
Configuration in TaskAGI:
- In TaskAGI, navigate to Integrations → Google Sheets
- Paste your service account email and private key
- Create a Google Sheet with two columns:
- Column A: "URL" (your webpage URLs to analyze)
- Column B: "SEO Analysis" (where results will be saved)
- Share the sheet with your service account email
- Copy the sheet URL (you'll need this for the "Get URLs from Sheet" and "Save to Sheet" nodes)
Browser Automation
Why it's needed: This integration fetches the actual webpage content that will be analyzed. It simulates a real browser visit to extract all text, metadata, and content from each URL.
Setup steps:
- Navigate to TaskAGI Integrations → Browser Automation
- This integration typically uses built-in browser capabilities (no external API key required)
- Verify that JavaScript rendering is enabled (needed for modern websites)
- Configure timeout settings (default 30 seconds is usually sufficient)
Configuration in TaskAGI:
-
Timeout: Set to
30000 milliseconds for most websites
-
Wait for selector: Leave blank unless specific elements need to load
-
JavaScript enabled: Toggle ON to handle dynamic content
Google Gemini
Why it's needed: Gemini is the AI engine that analyzes webpage content for SEO opportunities. It evaluates factors like keyword usage, meta descriptions, heading structure, content length, and more.
Setup steps:
- Visit Google AI Studio
- Click "Get API Key" in the top-right corner
- Select your Google Cloud project (or create a new one)
- Click "Create API Key"
- Copy your API key
How to obtain credentials:
Your API key appears immediately after creation. Copy it and store it securely.
Configuration in TaskAGI:
- Navigate to Integrations → Google Gemini
- Paste your API key
- The workflow uses Gemini 2.5 Flash model (fast and cost-effective)
- The pre-configured prompt analyzes:
- Title tag optimization
- Meta description quality
- Header hierarchy (H1, H2, H3 usage)
- Keyword density and placement
- Content length and readability
- Internal linking structure
- Image alt text optimization
Telegram
Why it's needed: Telegram delivers real-time notifications to your team whenever SEO analysis is complete. This keeps everyone informed and enables quick action on findings.
Setup steps:
- Open Telegram and search for @BotFather
- Start a conversation and type
/newbot
- Follow the prompts to name your bot (e.g., "SEO Analysis Bot")
- BotFather will provide your Bot Token
- Copy and save this token
How to obtain credentials:
The Bot Token is provided immediately by BotFather in the format: 123456789:ABCdefGHIjklmnoPQRstuvWXYZ
Configuration in TaskAGI:
- Navigate to Integrations → Telegram
- Paste your Bot Token
- Get your Chat ID:
- Start your bot in Telegram (search for your bot name and click "Start")
- Send any message to the bot
- Visit
https://api.telegram.org/bot[YOUR_BOT_TOKEN]/getUpdates
- Find your Chat ID in the response
- Save your Chat ID in TaskAGI
- Test by sending a message through the workflow
Configuration Steps
Step 1: Schedule Trigger Setup
The workflow runs automatically on a schedule. Configure when you want SEO analysis to occur:
- Click the Schedule Trigger node
- Set your desired frequency:
-
Daily:
0 9 * * * (9 AM every day)
-
Weekly:
0 9 * * 1 (9 AM every Monday)
-
Bi-weekly:
0 9 * * 0,3 (Sundays and Wednesdays)
- Select your timezone
- Save the configuration
Example: For daily morning analysis, use 0 9 * * * in your timezone.
Step 2: Get URLs from Sheet
This node retrieves all URLs from your Google Sheet:
- Click Get URLs from Sheet node
- Paste your sheet_url (the full URL of your Google Sheet)
- Specify the range where URLs are located:
A2:A (starts from row 2, column A)
- Ensure your sheet is shared with the service account email
- Test the connection by clicking "Test Node"
Expected output: A list of URLs ready for analysis.
Step 3: Loop Through URLs
This node processes each URL individually:
- Click Loop Through URLs node
- Set the input to the URLs from Step 2
- Configure loop settings:
-
Parallel execution: OFF (processes URLs sequentially to avoid rate limits)
-
Delay between iterations:
2000 milliseconds (2 seconds)
- This ensures smooth processing without overwhelming servers
Step 4: Fetch Page Content
For each URL, this node extracts the webpage content:
- Click Fetch Page Content node
- Set the URL input to the current loop item
- Configure options:
-
Timeout:
30000 milliseconds
-
JavaScript rendering: ON
-
Wait for page load: ON
- This node outputs the full HTML and text content
What it captures: Page title, meta tags, headings, body text, images, and links.
Step 5: SEO Analysis
The AI analyzes the fetched content:
- Click SEO Analysis node
- The prompt is pre-configured to analyze:
-
Title tag (length, keywords, uniqueness)
-
Meta description (length, call-to-action)
-
Headers (H1 presence, hierarchy)
-
Content (length, keyword usage, readability)
-
Images (alt text, optimization)
-
Links (internal linking, anchor text)
- Model is set to gemini-2.5-flash (optimal speed/quality balance)
- Output format: Structured JSON with scores and recommendations
Example output structure:
{
"title_optimization": {"score": 8, "feedback": "..."},
"meta_description": {"score": 7, "feedback": "..."},
"headers": {"score": 9, "feedback": "..."},
"recommendations": ["...", "..."]
}
Step 6: Parse SEO JSON
This node extracts structured data from the AI response:
- Click Parse SEO JSON node
- Set input to the SEO Analysis output
- Configure JSON path to extract:
-
$.title_optimization.score
-
$.meta_description.score
-
$.headers.score
-
$.recommendations
- This creates clean, usable data for the next steps
Step 7: Format Results
This node prepares data for saving to your sheet:
- Click Format Results node
- Create a function that combines:
- Original URL
- Overall SEO score
- Individual component scores
- Top 3 recommendations
- Example output format:
URL | Overall Score | Title | Meta | Headers | Top Recommendation
- This ensures consistent, readable formatting
Step 8: Save to Sheet
Results are automatically saved back to your Google Sheet:
- Click Save to Sheet node
- Paste your sheet_url (same sheet as Step 2)
- Set the range to column B:
B2:B
- Map the formatted results to this column
- Configure append settings:
-
Append mode: ON (adds new rows)
-
Include timestamp: ON (tracks when analysis ran)
Result: Your sheet now contains both URLs and their SEO analysis results.
Step 9: Notify Team
Send real-time notifications to your team:
- Click Notify Team node
- Set the Chat ID to your Telegram chat ID
- Create a message template:
🔍 SEO Analysis Complete
URL: {url}
Overall Score: {score}/10
Top Recommendations:
• {recommendation_1}
• {recommendation_2}
• {recommendation_3}
- Enable notifications for:
- Analysis completion
- Low scores (below 6/10)
- Critical issues detected
- Test by sending a test message
Testing Your Agent
Test Execution
Step 1: Prepare Test Data
- Create a test Google Sheet with 2-3 URLs you want to analyze
- Use real, published URLs (not localhost or staging sites)
- Example URLs:
-
https://www.example.com/blog/article-title
-
https://www.example.com/products/item
-
https://www.example.com/about-us
Step 2: Run Test Execution
- In TaskAGI, click the Test button on your workflow
- Select "Run Full Workflow"
- Monitor the execution in real-time
- Watch for any errors in the logs
Step 3: Verify Each Step
| Node |
What to Check |
Expected Result |
| Schedule Trigger |
Triggers correctly |
Workflow starts |
| Get URLs from Sheet |
Retrieves all URLs |
2-3 URLs in output |
| Loop Through URLs |
Processes each URL |
Loops 2-3 times |
| Fetch Page Content |
Extracts content |
HTML/text returned |
| SEO Analysis |
Generates analysis |
JSON with scores |
| Parse SEO JSON |
Extracts data |
Clean structured data |
| Format Results |
Formats output |
Readable format |
| Save to Sheet |
Saves results |
Data appears in Sheet |
| Notify Team |
Sends message |
Telegram notification received |
Success Indicators
✅ Workflow completed successfully when:
- All 9 nodes execute without errors
- URLs are fetched from your sheet
- SEO scores are generated (0-10 scale)
- Results appear in your Google Sheet within 2 minutes
- Telegram notification arrives with summary
- Execution time is under 5 minutes for 3 URLs
Troubleshooting
Issue: "Sheet URL not found"
- Verify the sheet is shared with your service account email
- Check that the URL is the full sheet URL, not a shortened link
Issue: "No content fetched from webpage"
- Ensure the URL is publicly accessible
- Check if the website blocks automated access
- Increase the timeout to 45000 milliseconds
Issue: "Telegram message not sent"
- Verify your Bot Token is correct
- Confirm you've started the bot in Telegram
- Check that Chat ID matches your conversation
Issue: "Low SEO scores across all pages"
- Review the AI recommendations in Telegram
- Implement suggested changes and re-run analysis
- Scores should improve after optimization
Congratulations! Your SEO Analysis Agent is now ready to automate your website optimization workflow. Monitor the results, implement recommendations, and watch your SEO performance improve automatically.