aidevops 2.52.1

package/.agent/seo.md

@@ -0,0 +1,236 @@
+---
+name: seo
+description: SEO optimization and analysis - keyword research, Search Console, DataForSEO, site crawling
+mode: subagent
+---
+
+# SEO - Main Agent
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: SEO optimization and analysis
+- **Tools**: Google Search Console, Ahrefs, DataForSEO, Serper, PageSpeed Insights, Context7
+- **MCP**: GSC, DataForSEO, Serper, Context7 for comprehensive SEO data and library docs
+- **Commands**: `/keyword-research`, `/autocomplete-research`, `/keyword-research-extended`
+
+**Subagents** (`seo/`):
+
+| Subagent | Purpose |
+|----------|---------|
+| `keyword-research.md` | Comprehensive keyword research with SERP weakness detection |
+| `google-search-console.md` | GSC queries and search performance |
+| `gsc-sitemaps.md` | Sitemap submission via Playwright browser automation |
+| `dataforseo.md` | Comprehensive SEO data APIs (SERP, keywords, backlinks) |
+| `serper.md` | Google Search API (web, images, news, places) |
+| `site-crawler.md` | SEO site auditing (Screaming Frog-like capabilities) |
+| `eeat-score.md` | E-E-A-T content quality scoring and analysis |
+
+**Key Operations**:
+- Keyword research with weakness detection (`/keyword-research-extended`)
+- Autocomplete long-tail expansion (`/autocomplete-research`)
+- Competitor keyword analysis (`--competitor`)
+- Keyword gap analysis (`--gap`)
+- Search performance analysis (GSC)
+- SERP analysis (DataForSEO, Serper)
+- Backlink analysis (Ahrefs, DataForSEO)
+- Page speed optimization (PageSpeed)
+
+**Commands**:
+
+```bash
+# Basic keyword research
+/keyword-research "best seo tools, keyword research"
+
+# Long-tail autocomplete expansion
+/autocomplete-research "how to lose weight"
+
+# Full SERP analysis with weakness detection
+/keyword-research-extended "dog training tips"
+
+# Competitor research
+/keyword-research-extended --competitor petco.com
+
+# Keyword gap analysis
+/keyword-research-extended --gap mysite.com,competitor.com
+```
+
+**MCP Integration**:
+
+```bash
+# GSC queries via MCP
+gsc_search_analytics [site] [query]
+gsc_index_status [site] [url]
+
+# DataForSEO via MCP
+dataforseo.serp [keyword] [location]
+dataforseo.keywords_data [keywords]
+dataforseo.backlinks [domain]
+
+# Serper via MCP
+serper.google_search [query]
+serper.google_search_news [query]
+```
+
+**Testing**: Use OpenCode CLI to test SEO commands without restarting TUI:
+
+```bash
+opencode run "/keyword-research 'test query'" --agent SEO
+```
+
+See `tools/opencode/opencode.md` for CLI testing patterns.
+
+<!-- AI-CONTEXT-END -->
+
+## SEO Workflow
+
+### Keyword Research (Primary)
+
+Use `/keyword-research` commands for comprehensive keyword analysis:
+
+```bash
+# Discovery workflow
+/keyword-research "seed keywords"           # Expand seed keywords
+/autocomplete-research "question phrase"    # Long-tail discovery
+/keyword-research-extended "top keywords"   # Full SERP analysis
+```
+
+See `seo/keyword-research.md` for complete documentation including:
+- 17 SERP weakness types
+- KeywordScore algorithm (0-100)
+- Domain/Competitor/Gap research modes
+- Provider configuration (DataForSEO, Serper, Ahrefs)
+
+### Search Performance
+
+Use Google Search Console MCP for:
+- Query performance data
+- Click-through rates
+- Position tracking
+- Index coverage
+
+See `seo/google-search-console.md` for query patterns.
+
+### SERP Analysis
+
+Use DataForSEO or Serper for real-time SERP data:
+- **DataForSEO**: Comprehensive SERP data with keyword metrics
+- **Serper**: Quick Google searches (web, images, news, places)
+
+See `seo/dataforseo.md` and `seo/serper.md` for usage.
+
+### Keyword Research (Legacy)
+
+Combine tools:
+- GSC for existing performance
+- DataForSEO for keyword data (volume, CPC, difficulty)
+- Ahrefs for competitor analysis
+- Content gap identification
+
+### Backlink Analysis
+
+- **DataForSEO**: Backlink data, referring domains, anchor text
+- **Ahrefs**: Comprehensive backlink profiles
+
+### Technical SEO
+
+- PageSpeed optimization (see `tools/browser/pagespeed.md`)
+- Core Web Vitals monitoring
+- Mobile usability
+- Structured data validation
+- On-page analysis (DataForSEO)
+- **Site crawling**: Use `site-crawler.md` for comprehensive audits
+
+### Site Auditing
+
+Use `seo/site-crawler.md` for Screaming Frog-like capabilities:
+
+```bash
+# Full site crawl
+site-crawler-helper.sh crawl https://example.com
+
+# Specific audits
+site-crawler-helper.sh audit-links https://example.com
+site-crawler-helper.sh audit-meta https://example.com
+site-crawler-helper.sh audit-redirects https://example.com
+```
+
+Output: `~/Downloads/{domain}/{datestamp}/` with CSV/XLSX reports.
+
+### E-E-A-T Content Quality
+
+Use `seo/eeat-score.md` for content quality analysis:
+
+```bash
+# Analyze crawled pages
+eeat-score-helper.sh analyze ~/Downloads/example.com/_latest/crawl-data.json
+
+# Score single URL
+eeat-score-helper.sh score https://example.com/article
+```
+
+Scores 7 criteria (1-10): Authorship, Citation, Effort, Originality, Intent, Subjective Quality, Writing.
+Output: `{domain}-eeat-score-{date}.xlsx` with scores and reasoning.
+
+### Sitemap Submission
+
+Use `seo/gsc-sitemaps.md` for automated sitemap submissions:
+
+```bash
+# Submit sitemap for single domain
+~/.aidevops/agents/scripts/gsc-sitemap-helper.sh submit example.com
+
+# Submit for multiple domains
+~/.aidevops/agents/scripts/gsc-sitemap-helper.sh submit example.com example.net example.org
+
+# Submit from file
+~/.aidevops/agents/scripts/gsc-sitemap-helper.sh submit --file domains.txt
+
+# Check status
+~/.aidevops/agents/scripts/gsc-sitemap-helper.sh status example.com
+```
+
+Uses Playwright browser automation with persistent Chrome profile. First-time setup requires `~/.aidevops/agents/scripts/gsc-sitemap-helper.sh login` to authenticate.
+
+### Content Optimization
+
+Integrate with `content.md` for:
+- Keyword-focused content creation
+- Meta optimization
+- Internal linking strategy
+
+## Tool Comparison
+
+| Feature | GSC | DataForSEO | Serper | Ahrefs |
+|---------|-----|------------|--------|--------|
+| Search Performance | Yes | No | No | No |
+| SERP Data | No | Yes | Yes | Yes |
+| Keyword Research | Limited | Yes | No | Yes |
+| Backlinks | No | Yes | No | Yes |
+| On-Page Analysis | No | Yes | No | Yes |
+| Local/Places | No | Yes | Yes | No |
+| News Search | No | Yes | Yes | No |
+| Pricing | Free | Subscription | Pay-per-search | Subscription |
+
+## Oh-My-OpenCode Integration
+
+When oh-my-opencode is installed, leverage these specialized agents for enhanced SEO workflows:
+
+| OmO Agent | When to Use | Example |
+|-----------|-------------|---------|
+| `@document-writer` | Content optimization, meta descriptions, SEO copywriting | "Ask @document-writer to optimize this article for 'keyword'" |
+| `@librarian` | Research SEO best practices, find implementation examples | "Ask @librarian for schema markup examples" |
+| `@multimodal-looker` | Analyze competitor screenshots, infographics | "Ask @multimodal-looker to analyze this competitor's page layout" |
+
+**Content Optimization Workflow**:
+
+```text
+1. /keyword-research "topic" → identify targets
+2. @document-writer → create optimized content
+3. E-E-A-T analysis → validate quality
+4. Technical SEO → implement schema, meta
+```
+
+**Note**: These agents require [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) plugin.
+See `tools/opencode/oh-my-opencode.md` for installation.

package/.agent/services/accounting/quickfile.md

@@ -0,0 +1,159 @@
+---
+description: QuickFile accounting API integration
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: false
+  glob: true
+  grep: true
+  webfetch: true
+---
+
+# QuickFile Agent
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: QuickFile UK accounting operations - invoices, clients, purchases, banking, reports
+- **Tool Prefix**: `quickfile_*`
+- **Credentials**: `~/.config/.quickfile-mcp/credentials.json`
+
+**Common Tasks**:
+
+| Task | Tool |
+|------|------|
+| Account info | `quickfile_system_get_account` |
+| Find clients | `quickfile_client_search` |
+| List invoices | `quickfile_invoice_search` |
+| Create invoice | `quickfile_invoice_create` |
+| P&L report | `quickfile_report_profit_loss` |
+| Outstanding debts | `quickfile_report_ageing` |
+
+**Example Prompts**:
+- "Show my QuickFile account details"
+- "Find all unpaid invoices"
+- "Create an invoice for Client X for consulting services"
+- "Get this year's profit and loss report"
+
+<!-- AI-CONTEXT-END -->
+
+## Description
+
+This agent provides access to QuickFile UK accounting software through the MCP server. Use it for:
+
+- **Client Management**: Create, search, update clients and contacts
+- **Invoicing**: Create and send invoices, estimates, credit notes
+- **Purchases**: Record purchase invoices from suppliers
+- **Banking**: View accounts, balances, and transactions
+- **Reporting**: P&L, Balance Sheet, VAT, Ageing reports
+
+## Available Tools
+
+### System
+
+- `quickfile_system_get_account` - Account details
+- `quickfile_system_search_events` - Event log
+- `quickfile_system_create_note` - Add notes
+
+### Clients
+
+- `quickfile_client_search` - Search clients
+- `quickfile_client_get` - Get client details
+- `quickfile_client_create` - New client
+- `quickfile_client_update` - Update client
+- `quickfile_client_delete` - Delete client
+- `quickfile_client_insert_contacts` - Add contact
+- `quickfile_client_login_url` - Client portal URL
+
+### Invoices
+
+- `quickfile_invoice_search` - Search invoices
+- `quickfile_invoice_get` - Get invoice
+- `quickfile_invoice_create` - Create invoice/estimate
+- `quickfile_invoice_delete` - Delete invoice
+- `quickfile_invoice_send` - Email invoice
+- `quickfile_invoice_get_pdf` - Get PDF URL
+- `quickfile_estimate_accept_decline` - Accept/decline estimate
+- `quickfile_estimate_convert_to_invoice` - Convert to invoice
+
+### Purchases
+
+- `quickfile_purchase_search` - Search purchases
+- `quickfile_purchase_get` - Get purchase
+- `quickfile_purchase_create` - Create purchase
+- `quickfile_purchase_delete` - Delete purchase
+
+### Suppliers
+
+- `quickfile_supplier_search` - Search suppliers
+- `quickfile_supplier_get` - Get supplier
+- `quickfile_supplier_create` - New supplier
+- `quickfile_supplier_delete` - Delete supplier
+
+### Banking
+
+- `quickfile_bank_get_accounts` - List accounts
+- `quickfile_bank_get_balances` - Get balances
+- `quickfile_bank_search` - Search transactions
+- `quickfile_bank_create_account` - New account
+- `quickfile_bank_create_transaction` - Add transaction
+
+### Reports
+
+- `quickfile_report_profit_loss` - P&L report
+- `quickfile_report_balance_sheet` - Balance sheet
+- `quickfile_report_vat_obligations` - VAT returns
+- `quickfile_report_ageing` - Debtor/creditor ageing
+- `quickfile_report_chart_of_accounts` - Nominal codes
+- `quickfile_report_subscriptions` - Recurring items
+
+## Example Prompts
+
+### Account Overview
+
+"Show me my QuickFile account details and this year's financial summary"
+
+### Client Operations
+
+"Search for clients in London"
+"Create a new client for Acme Ltd with email john@acme.com"
+"Update client 12345 with new address"
+
+### Invoice Operations
+
+"List all unpaid invoices from the last 30 days"
+"Create an invoice for client 12345 for 8 hours of consulting at £100/hour"
+"Send invoice 67890 to the client"
+"Get the PDF for invoice 67890"
+
+### Financial Reports
+
+"Generate a profit and loss report for Q1 2024"
+"Show me the balance sheet as of today"
+"List all open VAT returns"
+"Show me the debtor ageing report"
+
+### Purchase Operations
+
+"Record a purchase invoice from Amazon for £50 office supplies"
+"List all purchases from supplier 11111"
+
+## Security Notes
+
+- Credentials stored in `~/.config/.quickfile-mcp/credentials.json`
+- File should have 600 permissions
+- API calls are authenticated via MD5 hash
+- Default rate limit: 1000 calls/day
+
+## Related Agents
+
+- `@aidevops` - For infrastructure operations
+- `@code-standards` - For code review
+
+## Reference
+
+- [QuickFile API Documentation](https://api.quickfile.co.uk/)
+- [AGENTS.md](../AGENTS.md) - Full documentation