{"skill":{"slug":"rankforge-api","displayName":"rankforge-api","summary":"Comprehensive SEO analysis and optimization using RankForge API - SEO audit, website audit, keyword research, keyword analysis, search engine optimization, c...","description":"---\nname: rankforge-api\ndescription: \"Comprehensive SEO analysis and optimization using RankForge API - SEO audit, website audit, keyword research, keyword analysis, search engine optimization, competitor analysis, SERP analysis, ranking analysis, backlink analysis, technical SEO, on-page SEO, off-page SEO, keyword difficulty, search volume analysis, keyword suggestions, content optimization, meta tag analysis, site performance, SEO scoring, search rankings, organic traffic analysis, keyword tracking, SEO recommendations, site health check, crawl analysis, indexing issues, mobile SEO, page speed analysis, schema markup analysis, local SEO, and comprehensive search engine visibility optimization.\"\n---\n\n# RankForge API Skill\n\nPerform comprehensive SEO analysis and optimization using VCG's RankForge API - professional SEO auditing, keyword research, and competitor analysis tools.\n\n## Quick Start\n\n1. **Get API Key**: Help user sign up for free RankForge API key\n2. **Store Key**: Save the key securely \n3. **Run SEO Analysis**: Audit websites, research keywords, analyze competitors\n\n## API Key Signup\n\n### Step 1: Get User's Email\nAsk the user for their email address to create a free RankForge account.\n\n### Step 2: Sign Up via API\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/keys \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\":\"user@example.com\"}'\n```\n\n**Expected Response:**\n```json\n{\n  \"api_key\": \"rf_9876543210fedcba\",\n  \"message\": \"API key created successfully\",\n  \"tier\": \"free\",\n  \"daily_limit\": 50\n}\n```\n\n### Step 3: Store the API Key\nSave the API key securely for future use. Instruct the user to keep it safe.\n\n## Core SEO Analysis Features\n\n### Website SEO Audit\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/audit \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://example.com\",\n    \"depth\": \"full\",\n    \"include\": [\"technical\", \"content\", \"performance\", \"mobile\"]\n  }'\n```\n\n**Expected Response:**\n```json\n{\n  \"audit_id\": \"aud_12345\",\n  \"url\": \"https://example.com\",\n  \"overall_score\": 78,\n  \"issues\": {\n    \"critical\": 3,\n    \"warnings\": 12,\n    \"recommendations\": 8\n  },\n  \"categories\": {\n    \"technical_seo\": 85,\n    \"on_page_seo\": 72,\n    \"performance\": 68,\n    \"mobile_friendly\": 90\n  },\n  \"details\": \"Full audit report with actionable recommendations\"\n}\n```\n\n### Keyword Research\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/keywords/research \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"seed_keywords\": [\"digital marketing\", \"SEO tools\"],\n    \"location\": \"US\",\n    \"language\": \"en\",\n    \"include_metrics\": true\n  }'\n```\n\n**Expected Response:**\n```json\n{\n  \"keywords\": [\n    {\n      \"keyword\": \"digital marketing agency\",\n      \"search_volume\": 12000,\n      \"difficulty\": 65,\n      \"cpc\": 8.50,\n      \"competition\": \"high\",\n      \"related_keywords\": [\"marketing agency\", \"digital advertising\"]\n    }\n  ],\n  \"total_found\": 150,\n  \"suggestions\": 25\n}\n```\n\n### Competitor Analysis\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/competitors/analyze \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"target_url\": \"https://mysite.com\",\n    \"competitors\": [\"https://competitor1.com\", \"https://competitor2.com\"],\n    \"metrics\": [\"keywords\", \"backlinks\", \"content\", \"technical\"]\n  }'\n```\n\n**Expected Response:**\n```json\n{\n  \"target\": {\n    \"url\": \"https://mysite.com\",\n    \"domain_authority\": 45,\n    \"organic_keywords\": 2340,\n    \"total_backlinks\": 1250\n  },\n  \"competitors\": [\n    {\n      \"url\": \"https://competitor1.com\",\n      \"domain_authority\": 62,\n      \"organic_keywords\": 4580,\n      \"total_backlinks\": 3200,\n      \"gap_analysis\": {\n        \"keyword_opportunities\": 150,\n        \"content_gaps\": 23,\n        \"backlink_opportunities\": 85\n      }\n    }\n  ]\n}\n```\n\n### SERP Analysis\n```bash\ncurl -X GET \"https://rankforge.vosscg.com/v1/serp?keyword=digital%20marketing&location=US\" \\\n  -H \"X-API-Key: rf_9876543210fedcba\"\n```\n\n### Backlink Analysis\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/backlinks/analyze \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://example.com\",\n    \"filters\": {\n      \"domain_rating\": \">30\",\n      \"status\": \"active\",\n      \"type\": [\"follow\", \"nofollow\"]\n    }\n  }'\n```\n\n### Technical SEO Check\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/technical-seo \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://example.com\",\n    \"checks\": [\n      \"crawlability\",\n      \"indexability\", \n      \"page_speed\",\n      \"mobile_usability\",\n      \"schema_markup\",\n      \"ssl_certificate\"\n    ]\n  }'\n```\n\n### Keyword Tracking\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/rankings/track \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://example.com\",\n    \"keywords\": [\"seo tools\", \"keyword research\", \"rank tracking\"],\n    \"location\": \"US\",\n    \"device\": \"desktop\"\n  }'\n```\n\n## Advanced Features\n\n### Content Optimization Analysis\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/content/optimize \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://example.com/article\",\n    \"target_keyword\": \"SEO best practices\",\n    \"analysis_type\": \"comprehensive\"\n  }'\n```\n\n### Local SEO Analysis\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/local-seo \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"business\": {\n      \"name\": \"Local Business\",\n      \"address\": \"123 Main St, City, State\",\n      \"phone\": \"+1234567890\"\n    },\n    \"target_location\": \"City, State\"\n  }'\n```\n\n### Site Speed Analysis\n```bash\ncurl -X POST https://rankforge.vosscg.com/v1/performance/analyze \\\n  -H \"X-API-Key: rf_9876543210fedcba\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://example.com\",\n    \"device\": \"both\",\n    \"metrics\": [\"lcp\", \"fid\", \"cls\", \"ttfb\"]\n  }'\n```\n\n## Common Use Cases\n\n### Complete SEO Audit Workflow\n```bash\n# 1. Site audit\ncurl -X POST https://rankforge.vosscg.com/v1/audit \\\n  -H \"X-API-Key: [API_KEY]\" -d '{\"url\":\"site.com\"}'\n\n# 2. Keyword research\ncurl -X POST https://rankforge.vosscg.com/v1/keywords/research \\\n  -H \"X-API-Key: [API_KEY]\" -d '{\"seed_keywords\":[\"main topic\"]}'\n\n# 3. Competitor analysis\ncurl -X POST https://rankforge.vosscg.com/v1/competitors/analyze \\\n  -H \"X-API-Key: [API_KEY]\" -d '{\"target_url\":\"site.com\"}'\n\n# 4. Technical SEO check\ncurl -X POST https://rankforge.vosscg.com/v1/technical-seo \\\n  -H \"X-API-Key: [API_KEY]\" -d '{\"url\":\"site.com\"}'\n```\n\n## Error Handling\n\nCommon error responses:\n- `401 Unauthorized` - Invalid or missing API key\n- `429 Too Many Requests` - Daily limit exceeded (50 requests/day free)\n- `400 Bad Request` - Invalid URL or parameters\n- `404 Not Found` - URL not accessible for analysis\n- `503 Service Unavailable` - Analysis in progress, try again later\n\n## Pricing & Limits\n\n**Free Tier:**\n- 50 requests per day\n- Basic SEO audits\n- Keyword research (up to 100 keywords per query)\n- Competitor analysis (up to 3 competitors)\n- Technical SEO checks\n\n**Paid Plans:**\n- Upgrade at https://vosscg.com/forges for higher limits\n- Advanced analytics and historical data\n- White-label reports and API access\n- Priority processing and support\n\n## Best Practices\n\n1. **Comprehensive Audits**: Run full audits including technical, content, and performance\n2. **Regular Monitoring**: Set up keyword tracking for ongoing optimization\n3. **Competitor Intelligence**: Monitor competitor changes and opportunities\n4. **Action-Oriented**: Focus on high-impact recommendations first\n5. **Mobile-First**: Always include mobile analysis in audits\n6. **Local Optimization**: Use local SEO tools for location-based businesses\n\n## Integration Examples\n\n### OpenClaw Agent Workflow\n```bash\n# Help user get API key\ncurl -X POST https://rankforge.vosscg.com/v1/keys -d '{\"email\":\"user@domain.com\"}'\n\n# Run comprehensive SEO analysis based on user request\ncurl -X POST https://rankforge.vosscg.com/v1/audit \\\n  -H \"X-API-Key: [USER_API_KEY]\" \\\n  -d '{\"url\":\"[USER_WEBSITE]\", \"depth\":\"full\"}'\n\n# Present actionable insights and recommendations\n```\n\nWhen users need SEO analysis, want to improve search rankings, research keywords, audit website performance, or analyze competitors, use this skill to provide professional-grade SEO insights through RankForge's comprehensive analysis tools.","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":180,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772646532806,"updatedAt":1778491721623},"latestVersion":{"version":"1.0.0","createdAt":1772646532806,"changelog":"Initial release","license":null},"metadata":null,"owner":{"handle":"jbennett111","userId":"s17beqnsq226rr8b6jae5q2k7h885qrd","displayName":"Jbennett111","image":"https://avatars.githubusercontent.com/u/86585533?v=4"},"moderation":null}