aidevops 2.52.1 → 2.53.1

package/.agent/seo.md

@@ -1,236 +0,0 @@
----
-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

@@ -1,159 +0,0 @@
----
-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