adding documentation for the local seo tools of Agent WordLift

Author: cyberandy

docs/agent-wordlift/images/agent-wordlift-local-seo-local-pack.png

@@ -8,7 +8,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
 :::info Version Notice
-Latest Release: 3.6.0 (February 2025) - Now with enhanced support for Reddit content research and social media workflows!
+Latest Release: 3.6.1 (March 2025) - Now with enhanced support for Local SEO workflows!
 :::
 
 # 🤖 Welcome to Agent WordLift - Your Marketing & AI SEO Agent
@@ -85,6 +85,7 @@ Based on the provided workflows and prompt library, I'll help you revise the Qui
 * [Keyword Research](./workflows/keyword-discovery.md)
 * [Reddit Content Research](./workflows/research-content-ideas.md)
 * [Newsletter Ideas](./workflows/ideas-for-newsletters.md)
+* [Local SEO Analysis](./workflows/local-seo-analysis.md)
 
 </div>
 <div className="col col--6">

docs/agent-wordlift/images/agent-wordlift-local-seo-profile.png

@@ -24,5 +24,8 @@ Here is how WordLift AI SEO Agent can help you boost your productivity in differ
   - [Align Content with Search Query](./workflows/analyzing-query-match.md)
   - [Add Authorship Markup](./workflows/adding-authorship-markup.md)
 
+- **Optimize Local Presence:**
+  - [Local SEO Analysis](./workflows/local-seo-analysis.md)
+
 - **Enhance Structure:**
   - [Create Internal Links](./workflows/create-internal-links.md)

docs/agent-wordlift/images/agent-wordlift-local-seo-qa.png

@@ -0,0 +1,140 @@
+---
+title: Local SEO Analysis
+sidebar_position: 20
+---
+
+# Optimizing Local Search Performance
+
+Local SEO is critical for businesses that serve specific geographic areas. This workflow demonstrates how to use **Agent WordLift's Local SEO tools** to analyze and optimize your business's local search presence. For more background on local SEO strategies, read our comprehensive guide: [Optimizing Local SEO - How to Create Winning Strategies](https://wordlift.io/blog/en/optimizing-local-seo/).
+
+## Business Profile Analysis
+
+Start by analyzing your Google Business Profile to understand its current state and identify optimization opportunities.
+
+```md className=wlx-send-to-agent
+Analyze the Google Business Profile for "Mountain View Cafe" in "Denver,Colorado,United States"
+```
+
+This analysis provides comprehensive information about:
+
+- Basic business information (name, address, phone, website)
+- Ratings and review count
+- Business hours and attributes
+- Categories and popular topics
+- Images and additional features
+
+![image](../images/agent-wordlift-local-seo-profile.png)
+
+## Local Pack Research
+
+Understanding which businesses appear in Google's Local Pack for relevant keywords helps you identify competitive factors and optimization opportunities.
+
+```md className=wlx-send-to-agent
+Show me the Local Pack results for "coffee shops" in "Denver,Colorado,United States"
+```
+
+The Agent will return:
+
+- Businesses currently ranking in the Local Pack
+- Their ratings and review counts
+- Key attributes contributing to their rankings
+
+![image](../images/agent-wordlift-local-seo-local-pack.png)
+
+## Business Ranking Analysis
+
+Track your business's position in both Local Pack and organic search results for important keywords:
+
+```md className=wlx-send-to-agent
+Track the rankings of "Little Owl Coffee" for "coffee shop nearby" in "Denver,Colorado,United States"```
+
+This analysis reveals:
+
+- If your business appears in the Local Pack
+- Your position in organic search results
+- Snippets shown in search results
+- Overall visibility for target keywords
+
+![image](../images/agent-wordlift-local-seo-tracking.png)
+
+## Customer Q&A Analysis
+
+The questions customers ask on your Google Business Profile provide valuable insights into their needs and interests.
+
+```md className=wlx-send-to-agent
+Analyze questions and answers for "Mountain View Cafe" in "Denver,Colorado,United States"
+```
+
+This provides:
+
+- All customer questions (both answered and unanswered)
+- Analysis of business response patterns
+- Common question topics
+- Engagement timeline and metrics
+
+![image](../images/agent-wordlift-local-seo-qa.png)
+
+## Comprehensive Local SEO Audit
+
+For a complete assessment, combine multiple analyses into a comprehensive audit:
+
+```md className=wlx-send-to-agent
+Perform a complete local SEO audit for "Mountain View Cafe" in "Denver,Colorado,United States".
+1. Analyze their Google Business Profile
+2. Track their rankings for "best coffee shop" and "breakfast cafe"
+3. Examine the Local Pack for "coffee shops near me"
+4. Review their customer Q&A
+5. Provide actionable recommendations for improvement
+```
+
+This comprehensive approach delivers a detailed report with actionable insights for improving your local search presence.
+
+## Competitor Analysis
+
+Compare your business against local competitors to identify strengths, weaknesses, and opportunities:
+
+```md className=wlx-send-to-agent
+Compare "Mountain View Cafe" with competitors "Little Owl Coffee" and "Mile High Brews" in "Denver,Colorado,United States". Analyze their Google Business Profiles, track their rankings for "coffee shops", and identify competitive advantages.```
+
+This analysis helps you understand:
+
+- How your profile compares to competitors
+- What factors might be helping competitors rank better
+- Specific opportunities to improve your competitive position
+
+## Best Practices for Local SEO
+
+Based on the insights gathered, implement these best practices:
+
+1. **Complete Your Business Profile**
+   - Ensure all information is accurate and comprehensive
+   - Add high-quality photos of your business
+   - Select all relevant categories and attributes
+
+2. **Actively Manage Reviews**
+   - Respond promptly to all reviews, both positive and negative
+   - Thank customers for positive feedback
+   - Address concerns professionally in negative reviews
+
+3. **Answer Customer Questions**
+   - Monitor and respond to all questions in a timely manner
+   - Provide clear, helpful answers that showcase your expertise
+   - Use questions to identify information gaps in your profile
+
+4. **Optimize for Local Keywords**
+   - Include location-specific terms in your business description
+   - Target keywords that show local intent
+   - Create content addressing local needs and interests
+
+5. **Maintain Consistent NAP Information**
+   - Ensure your Name, Address, and Phone number are consistent across all platforms
+   - Verify information on popular directories and citation sites
+   - Update all listings when information changes
+
+:::tip
+Use the Local SEO tools regularly to monitor your progress and identify new opportunities for optimization. Local search rankings can change frequently, so consistent monitoring is key to maintaining and improving your position.
+:::
+
+For detailed information about each Local SEO tool and its capabilities, see our [Local SEO Tools Reference Guide](./local-seo-tools-guide.md).
+
+By following this workflow and implementing the recommended optimizations, you can improve your business's visibility in local search results, attract more relevant customers, and gain an advantage over competitors in your area.

docs/agent-wordlift/images/agent-wordlift-local-seo-tracking.png

@@ -0,0 +1,206 @@
+---
+title: Local SEO Tools Reference
+sidebar_position: 21
+---
+
+# Local SEO Tools Reference
+
+This guide provides detailed information about Agent WordLift's Local SEO tools, their capabilities, and technical specifications. For a strategic overview of local SEO best practices, see our article on [Optimizing Local SEO - How to Create Winning Strategies](https://wordlift.io/blog/en/optimizing-local-seo/).
+
+## Available Tools
+
+### Google Business Profile Analyzer
+
+Provides comprehensive information about any business's Google Business Profile.
+
+**Key capabilities:**
+
+- Retrieve complete business information (name, address, phone, website)
+- Access ratings, review counts, and business attributes
+- View business hours, popular topics, and categories
+- Analyze images and additional features
+
+**Usage syntax:**
+
+```md
+Analyze the Google Business Profile for "[business name]" in "[City,State,Country]"
+```
+
+**Advanced options:**
+
+- Use CID, place_id, or spp identifiers for precise targeting:
+
+```md
+Analyze the Google Business Profile using cid:[number]
+```
+
+or
+
+```md
+Analyze the Google Business Profile using place_id:[value]
+```
+
+### Local Pack Analyzer
+
+Examines Google's Local Pack results for specific search queries and locations.
+
+**Key capabilities:**
+
+- Identify businesses appearing in the Local Pack
+- Retrieve ratings and review information
+- Analyze business attributes and characteristics
+- Understand ranking factors for Local Pack inclusion
+
+**Usage syntax:**
+
+```md
+Show me the Local Pack results for "[keyword]" in "[City,State,Country]"
+```
+
+**Example keywords:**
+
+- Service-based: "plumbers", "electricians", "lawyers"
+- Product-based: "coffee shops", "bookstores", "pharmacies"
+- Specific queries: "best pizza delivery", "emergency dentist"
+
+### Business Ranking Tracker
+
+Monitors a business's position in both Local Pack and organic search results.
+
+**Key capabilities:**
+
+- Check if a business appears in the Local Pack
+- Identify position in organic search results
+- View snippets and featured content
+- Compare visibility across multiple keywords
+
+**Usage syntax:**
+
+```md
+Track the rankings of "[business name]" for "[keyword]" in "[City,State,Country]"
+```
+
+**Advanced use:**
+
+- Track multiple keywords in one request:
+
+```md
+Track the rankings of "[business name]" for these keywords: "[keyword1]", "[keyword2]", "[keyword3]" in "[City,State,Country]"
+```
+
+### Q&A Analysis Tool
+
+Examines customer questions and business responses on Google Business Profiles.
+
+**Key capabilities:**
+
+- Review all customer questions (answered and unanswered)
+- Analyze business response patterns and response rate
+- Identify common question topics and trends
+- Evaluate engagement metrics over time
+
+**Usage syntax:**
+
+```md
+Analyze questions and answers for "[business name]" in "[City,State,Country]"
+```
+
+**Analysis depth:**
+
+- Standard depth (default): Retrieves approximately 20 questions
+- Deep analysis: Add depth parameter for more questions:
+
+```md
+Analyze questions and answers for "[business name]" in "[City,State,Country]" with depth:50
+```
+
+## Technical Notes
+
+### Location Format
+
+For optimal results, use the following format for locations:
+
+- `City,State,Country` without spaces after commas
+- Examples: `Manhattan,New York,United States` or `Rome,Lazio,Italy`
+- For general searches, you can use just the country: `United States`
+
+### Language Support
+
+These tools support multiple languages. Specify the language code for non-English searches:
+
+```md
+Analyze the Google Business Profile for "[business name]" in "[City,State,Country]" in language:fr
+```
+
+Supported language codes include:
+
+- `en` - English (default)
+- `fr` - French
+- `es` - Spanish
+- `de` - German
+- `it` - Italian
+- And many more
+
+### Data Freshness
+
+The data returned by these tools is typically current within 24-48 hours of changes to Google's search results or business listings.
+
+### Data Limitations
+
+While these tools provide comprehensive information, some limitations apply:
+
+- Image content analysis is not available
+- Detailed review content may be limited
+- Internal business metrics are not accessible
+- Some data may be unavailable for businesses with minimal online presence
+
+## Integration Examples
+
+### Combining Multiple Tools
+
+For comprehensive analysis, combine multiple tools in a single request:
+
+```md
+For "Mountain View Cafe" in "Denver,Colorado,United States":
+1. Analyze their Google Business Profile
+2. Check their rankings for "best coffee shop"
+3. Examine their customer Q&A
+4. Provide an overall assessment and recommendations
+```
+
+### Cross-Location Analysis
+
+Compare the same business across different locations:
+
+```md
+Compare the Google Business Profiles and local rankings for:
+1. Starbucks in "Seattle,Washington,United States"
+2. Starbucks in "New York,New York,United States"
+3. Starbucks in "Chicago,Illinois,United States"
+Highlight key differences and location-specific factors.
+```
+
+### Competitive Analysis
+
+Compare multiple businesses in the same location:
+
+```md
+Analyze and compare these three restaurants in "Boston,Massachusetts,United States":
+1. "Legal Sea Foods"
+2. "Union Oyster House"
+3. "Neptune Oyster"
+Compare their profiles, rankings, and customer engagement.
+```
+
+## Common Error Troubleshooting
+
+If you encounter errors, try these solutions:
+
+| Error Message | Likely Cause | Solution |
+|---------------|--------------|----------|
+| "Invalid location format" | Incorrect location formatting | Use format "City,State,Country" without spaces after commas |
+| "No Google Business Profile found" | Business name not recognized | Try adding location to name, use more popular name variation, or use identifier if available |
+| "No search results found" | Low search volume or niche keyword | Try more popular or broader keywords |
+| "Request failed" | Temporary API issue | Wait a few moments and try again |
+
+By using these tools effectively, you can gain valuable insights into your local search presence and make data-driven optimization decisions.