{"openapi":"3.0.0","info":{"title":"SEO Utility API","version":"1.0.0","description":"25+ SEO generation and analysis endpoints — JSON-LD structured data, Open Graph tags, Twitter Cards, robots.txt, sitemap.xml, title/description analysis, agent readiness scoring."},"servers":[{"url":"https://api.computetools.workers.dev"}],"paths":{"/api/seo_jsonld_article":{"post":{"description":"Generate JSON-LD for Article schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"How to Improve Your SEO in 2025","description":"Article title"},"author":{"type":"string","example":"Jane Smith","description":"Author name"},"date_published":{"type":"string","example":"2025-01-15","description":"Publication date (ISO 8601)"},"description":{"type":"string","example":"A comprehensive guide to modern SEO techniques.","description":"Article description"},"image_url":{"type":"string","format":"uri","example":"https://example.com/article.jpg","description":"Featured image URL"},"publisher_name":{"type":"string","example":"SEO Weekly","description":"Publisher name"}},"required":["title","author","date_published","description","publisher_name"]}}}},"responses":{"200":{"description":"Article JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_article"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"Article"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_product":{"post":{"description":"Generate JSON-LD for Product schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"Wireless Mouse","description":"Product name"},"description":{"type":"string","example":"Ergonomic wireless mouse with USB-C charging.","description":"Product description"},"price":{"type":"number","minimum":0,"example":29.99,"description":"Product price"},"currency":{"type":"string","minLength":3,"maxLength":3,"example":"USD","description":"ISO 4217 currency code"},"brand":{"type":"string","example":"TechBrand","description":"Brand name"},"availability":{"type":"string","enum":["InStock","OutOfStock","PreOrder","Discontinued"],"example":"InStock","description":"Product availability"},"image_url":{"type":"string","format":"uri","example":"https://example.com/mouse.jpg","description":"Product image URL"},"sku":{"type":"string","example":"WM-2025-BLK","description":"Stock Keeping Unit"}},"required":["name","description","price","currency","brand","availability"]}}}},"responses":{"200":{"description":"Product JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_product"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"Product"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_faq":{"post":{"description":"Generate JSON-LD for FAQPage schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"questions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","example":"What is SEO?"},"answer":{"type":"string","example":"SEO stands for Search Engine Optimization."}},"required":["question","answer"]},"minItems":1,"description":"Array of FAQ question/answer pairs"}},"required":["questions"]}}}},"responses":{"200":{"description":"FAQ JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_faq"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"FAQPage"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_howto":{"post":{"description":"Generate JSON-LD for HowTo schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"How to Change a Tire","description":"HowTo title"},"description":{"type":"string","example":"Step-by-step guide to changing a flat tire.","description":"HowTo description"},"steps":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","example":"Loosen the lug nuts with a wrench."},"image_url":{"type":"string","format":"uri","example":"https://example.com/step1.jpg"}},"required":["text"]},"minItems":1,"description":"Ordered steps"},"total_time":{"type":"string","example":"PT30M","description":"Total time in ISO 8601 duration format"}},"required":["name","description","steps","total_time"]}}}},"responses":{"200":{"description":"HowTo JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_howto"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"HowTo"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_local_business":{"post":{"description":"Generate JSON-LD for LocalBusiness schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"Joe's Coffee Shop","description":"Business name"},"address":{"type":"object","properties":{"street":{"type":"string","example":"123 Main St"},"city":{"type":"string","example":"Springfield"},"state":{"type":"string","example":"IL"},"postal_code":{"type":"string","example":"62701"},"country":{"type":"string","example":"US"}},"required":["street","city","state","postal_code","country"],"description":"Business address"},"phone":{"type":"string","example":"+1-555-123-4567","description":"Phone number"},"opening_hours":{"type":"array","items":{"type":"string"},"example":["Mo-Fr 07:00-18:00","Sa 08:00-14:00"],"description":"Opening hours in schema.org format"},"geo":{"type":"object","properties":{"latitude":{"type":"number","example":39.7817},"longitude":{"type":"number","example":-89.6501}},"required":["latitude","longitude"],"description":"Geographic coordinates"}},"required":["name","address","phone","opening_hours"]}}}},"responses":{"200":{"description":"LocalBusiness JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_local_business"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"LocalBusiness"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_breadcrumb":{"post":{"description":"Generate JSON-LD for BreadcrumbList schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Home"},"url":{"type":"string","format":"uri","example":"https://example.com/"}},"required":["name","url"]},"minItems":1,"description":"Ordered breadcrumb items"}},"required":["items"]}}}},"responses":{"200":{"description":"BreadcrumbList JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_breadcrumb"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"BreadcrumbList"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_event":{"post":{"description":"Generate JSON-LD for Event schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"Tech Conference 2025","description":"Event name"},"start_date":{"type":"string","example":"2025-06-15T09:00:00-07:00","description":"Start date (ISO 8601)"},"end_date":{"type":"string","example":"2025-06-17T17:00:00-07:00","description":"End date (ISO 8601)"},"location":{"type":"string","example":"Moscone Center, San Francisco, CA","description":"Event location"},"description":{"type":"string","example":"Annual technology conference with keynotes and workshops.","description":"Event description"},"url":{"type":"string","format":"uri","example":"https://techconf2025.example.com","description":"Event URL"}},"required":["name","start_date","location","description"]}}}},"responses":{"200":{"description":"Event JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_event"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"Event"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_recipe":{"post":{"description":"Generate JSON-LD for Recipe schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"Classic Chocolate Chip Cookies","description":"Recipe name"},"ingredients":{"type":"array","items":{"type":"string"},"minItems":1,"example":["2 cups flour","1 cup sugar","1 cup chocolate chips"],"description":"List of ingredients"},"instructions":{"type":"array","items":{"type":"string"},"minItems":1,"example":["Preheat oven to 375°F.","Mix dry ingredients.","Bake for 10 minutes."],"description":"Ordered instructions"},"prep_time":{"type":"string","example":"PT15M","description":"Prep time in ISO 8601 duration"},"cook_time":{"type":"string","example":"PT10M","description":"Cook time in ISO 8601 duration"},"servings":{"type":"integer","minimum":0,"exclusiveMinimum":true,"example":24,"description":"Number of servings"}},"required":["name","ingredients","instructions","prep_time","cook_time","servings"]}}}},"responses":{"200":{"description":"Recipe JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_recipe"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"Recipe"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_jsonld_review":{"post":{"description":"Generate JSON-LD for Review schema","tags":["SEO - Structured Data"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"item_name":{"type":"string","example":"Wireless Mouse","description":"Name of the reviewed item"},"rating":{"type":"number","minimum":1,"maximum":5,"example":4.5,"description":"Rating value (1-5)"},"author":{"type":"string","example":"John Doe","description":"Review author"},"review_body":{"type":"string","example":"Excellent build quality and battery life.","description":"Review text"},"date":{"type":"string","example":"2025-03-01","description":"Review date (ISO 8601)"}},"required":["item_name","rating","author","review_body","date"]}}}},"responses":{"200":{"description":"Review JSON-LD generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_jsonld_review"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"Review"}}},"required":["jsonld"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_meta_tags":{"post":{"description":"Generate complete HTML meta tags for SEO","tags":["SEO - Meta Tags"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"Best SEO Practices 2025 | SEO Weekly","description":"Page title"},"description":{"type":"string","example":"Learn the latest SEO strategies to boost your rankings.","description":"Meta description"},"keywords":{"type":"array","items":{"type":"string"},"example":["SEO","search engine","ranking"],"description":"Meta keywords"},"canonical_url":{"type":"string","format":"uri","example":"https://example.com/seo-guide","description":"Canonical URL"},"author":{"type":"string","example":"Jane Smith","description":"Author name"},"robots":{"type":"string","example":"index, follow","description":"Robots directive"}},"required":["title","description"]}}}},"responses":{"200":{"description":"Meta tags generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_meta_tags"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"html":{"type":"string","example":"\n..."}},"required":["html"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_og_tags":{"post":{"description":"Generate Open Graph meta tags","tags":["SEO - Meta Tags"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"Best SEO Practices 2025","description":"OG title"},"description":{"type":"string","example":"Learn SEO strategies for 2025.","description":"OG description"},"url":{"type":"string","format":"uri","example":"https://example.com/seo-guide","description":"Page URL"},"image":{"type":"string","format":"uri","example":"https://example.com/og-image.jpg","description":"OG image URL"},"type":{"type":"string","default":"website","example":"article","description":"OG type (website, article, etc.)"},"site_name":{"type":"string","example":"SEO Weekly","description":"Site name"}},"required":["title","description","url"]}}}},"responses":{"200":{"description":"OG tags generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_og_tags"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"html":{"type":"string","example":""}},"required":["html"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_twitter_card":{"post":{"description":"Generate Twitter Card meta tags","tags":["SEO - Meta Tags"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"Best SEO Practices 2025","description":"Card title"},"description":{"type":"string","example":"Learn SEO strategies for 2025.","description":"Card description"},"image":{"type":"string","format":"uri","example":"https://example.com/twitter-card.jpg","description":"Card image URL"},"card_type":{"type":"string","enum":["summary","summary_large_image"],"default":"summary","example":"summary_large_image","description":"Twitter card type"},"site_handle":{"type":"string","example":"@seoweekly","description":"Site Twitter handle"}},"required":["title","description"]}}}},"responses":{"200":{"description":"Twitter card tags generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_twitter_card"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"html":{"type":"string","example":""}},"required":["html"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_canonical":{"post":{"description":"Generate canonical link tag","tags":["SEO - Meta Tags"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","example":"https://example.com/seo-guide","description":"Canonical URL"}},"required":["url"]}}}},"responses":{"200":{"description":"Canonical tag generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_canonical"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"html":{"type":"string","example":""}},"required":["html"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_robots_txt":{"post":{"description":"Generate robots.txt content","tags":["SEO - Technical"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"allowed_paths":{"type":"array","items":{"type":"string"},"default":[],"example":["/"],"description":"Allowed paths"},"disallowed_paths":{"type":"array","items":{"type":"string"},"default":[],"example":["/admin/","/private/"],"description":"Disallowed paths"},"sitemaps":{"type":"array","items":{"type":"string","format":"uri"},"default":[],"example":["https://example.com/sitemap.xml"],"description":"Sitemap URLs"},"crawl_delay":{"type":"integer","minimum":0,"exclusiveMinimum":true,"example":10,"description":"Crawl delay in seconds"}}}}}},"responses":{"200":{"description":"robots.txt generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_robots_txt"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"content":{"type":"string","example":"User-agent: *\nAllow: /\nDisallow: /admin/"}},"required":["content"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_sitemap_xml":{"post":{"description":"Generate sitemap.xml content","tags":["SEO - Technical"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri","example":"https://example.com/"},"lastmod":{"type":"string","example":"2025-01-15"},"changefreq":{"type":"string","enum":["always","hourly","daily","weekly","monthly","yearly","never"],"example":"weekly"},"priority":{"type":"number","minimum":0,"maximum":1,"example":0.8}},"required":["url"]},"minItems":1,"description":"Array of URL entries"}},"required":["urls"]}}}},"responses":{"200":{"description":"sitemap.xml generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_sitemap_xml"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"xml":{"type":"string","example":"..."}},"required":["xml"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_hreflang":{"post":{"description":"Generate hreflang link tags for multi-language pages","tags":["SEO - Technical"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"links":{"type":"array","items":{"type":"object","properties":{"lang":{"type":"string","example":"en"},"url":{"type":"string","format":"uri","example":"https://example.com/en/page"}},"required":["lang","url"]},"minItems":1,"description":"Array of language/URL pairs"}},"required":["links"]}}}},"responses":{"200":{"description":"Hreflang tags generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_hreflang"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"html":{"type":"string","example":""}},"required":["html"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_redirect_map":{"post":{"description":"Generate redirect map with analysis","tags":["SEO - Technical"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"redirects":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","example":"/old-page"},"to":{"type":"string","example":"/new-page"},"status_code":{"type":"string","enum":["301","302"],"example":"301"}},"required":["from","to","status_code"]},"minItems":1,"description":"Array of redirect rules"}},"required":["redirects"]}}}},"responses":{"200":{"description":"Redirect map generated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_redirect_map"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"redirects":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"status_code":{"type":"string"},"type":{"type":"string"}},"required":["from","to","status_code","type"]}},"total":{"type":"number"},"permanent_count":{"type":"number"},"temporary_count":{"type":"number"}},"required":["redirects","total","permanent_count","temporary_count"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_title_check":{"post":{"description":"Analyze SEO title for length, keyword presence, and readability","tags":["SEO - Analysis"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"Best SEO Practices for 2025 | SEO Weekly","description":"Page title to analyze"},"target_keyword":{"type":"string","example":"SEO Practices","description":"Target keyword to check for"}},"required":["title"]}}}},"responses":{"200":{"description":"Title analysis complete","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_title_check"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"title":{"type":"string"},"length":{"type":"number"},"length_ok":{"type":"boolean"},"keyword_present":{"type":"boolean"},"keyword_at_start":{"type":"boolean"},"issues":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["title","length","length_ok","issues","recommendations"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_description_check":{"post":{"description":"Analyze meta description for length, keywords, and call to action","tags":["SEO - Analysis"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","example":"Learn the latest SEO strategies to boost your rankings in 2025. Discover actionable tips from industry experts.","description":"Meta description to analyze"},"target_keyword":{"type":"string","example":"SEO strategies","description":"Target keyword to check for"}},"required":["description"]}}}},"responses":{"200":{"description":"Description analysis complete","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_description_check"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"description":{"type":"string"},"length":{"type":"number"},"length_ok":{"type":"boolean"},"keyword_present":{"type":"boolean"},"has_call_to_action":{"type":"boolean"},"issues":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["description","length","length_ok","has_call_to_action","issues","recommendations"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_heading_structure":{"post":{"description":"Analyze heading hierarchy from HTML for SEO best practices","tags":["SEO - Analysis"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string","example":"

Main Title

Section

Subsection

Another Section

","description":"HTML string to analyze headings from"}},"required":["html"]}}}},"responses":{"200":{"description":"Heading analysis complete","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_heading_structure"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"headings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"text":{"type":"string"}},"required":["level","text"]}},"h1_count":{"type":"number"},"issues":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}},"valid_hierarchy":{"type":"boolean"}},"required":["headings","h1_count","issues","recommendations","valid_hierarchy"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_keyword_density":{"post":{"description":"Calculate keyword density in text content","tags":["SEO - Analysis"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","example":"SEO is important for your website. Good SEO practices help improve rankings. SEO tools can automate tasks.","description":"Text content to analyze"},"keyword":{"type":"string","example":"SEO","description":"Keyword to check density for"}},"required":["text","keyword"]}}}},"responses":{"200":{"description":"Keyword density calculated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_keyword_density"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"keyword":{"type":"string"},"count":{"type":"number"},"total_words":{"type":"number"},"density_percentage":{"type":"number"},"assessment":{"type":"string"}},"required":["keyword","count","total_words","density_percentage","assessment"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_internal_links":{"post":{"description":"Analyze internal link structure for orphaned pages and link distribution","tags":["SEO - Analysis"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pages":{"type":"array","items":{"type":"object","properties":{"page_url":{"type":"string","example":"https://example.com/"},"links":{"type":"array","items":{"type":"string"},"example":["https://example.com/about","https://example.com/contact"]}},"required":["page_url","links"]},"minItems":1,"description":"Array of pages with their internal links"}},"required":["pages"]}}}},"responses":{"200":{"description":"Internal link analysis complete","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_internal_links"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"total_pages":{"type":"number"},"total_internal_links":{"type":"number"},"orphaned_pages":{"type":"array","items":{"type":"string"}},"most_linked":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"incoming_links":{"type":"number"}},"required":["url","incoming_links"]}},"pages_with_no_outgoing_links":{"type":"array","items":{"type":"string"}}},"required":["total_pages","total_internal_links","orphaned_pages","most_linked","pages_with_no_outgoing_links"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_image_alt_check":{"post":{"description":"Check images for missing or empty alt text","tags":["SEO - Analysis"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"src":{"type":"string","example":"https://example.com/hero.jpg"},"alt":{"type":"string","example":"Hero banner showing office workspace"}},"required":["src","alt"]},"minItems":1,"description":"Array of images with src and alt attributes"}},"required":["images"]}}}},"responses":{"200":{"description":"Image alt check complete","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_image_alt_check"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"total_images":{"type":"number"},"missing_alt":{"type":"array","items":{"type":"string"}},"empty_alt":{"type":"array","items":{"type":"string"}},"valid_alt_count":{"type":"number"},"score_percentage":{"type":"number"}},"required":["total_images","missing_alt","empty_alt","valid_alt_count","score_percentage"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_agent_readiness_score":{"post":{"description":"Score a page for agent/AI readiness with recommendations","tags":["SEO - Agent Optimization"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"has_jsonld":{"type":"boolean","example":true,"description":"Page has JSON-LD structured data"},"has_og":{"type":"boolean","example":true,"description":"Page has Open Graph tags"},"has_meta_desc":{"type":"boolean","example":true,"description":"Page has meta description"},"has_canonical":{"type":"boolean","example":true,"description":"Page has canonical URL"},"has_sitemap":{"type":"boolean","example":true,"description":"Site has sitemap.xml"},"has_robots":{"type":"boolean","example":true,"description":"Site has robots.txt"},"has_llms_txt":{"type":"boolean","example":false,"description":"Site has llms.txt file"}},"required":["has_jsonld","has_og","has_meta_desc","has_canonical","has_sitemap","has_robots","has_llms_txt"]}}}},"responses":{"200":{"description":"Agent readiness score calculated","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_agent_readiness_score"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"score":{"type":"number"},"max_score":{"type":"number"},"grade":{"type":"string"},"checks":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"passed":{"type":"boolean"},"points":{"type":"number"}},"required":["name","passed","points"]}},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["score","max_score","grade","checks","recommendations"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}},"/api/seo_schema_validate":{"post":{"description":"Validate JSON-LD structure for common schema.org types","tags":["SEO - Agent Optimization"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"jsonld":{"type":"object","additionalProperties":{},"example":{"@context":"https://schema.org","@type":"Article","headline":"Test"},"description":"JSON-LD object to validate"}},"required":["jsonld"]}}}},"responses":{"200":{"description":"Schema validation complete","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","example":"seo_schema_validate"},"category":{"type":"string","example":"seo"},"result":{"type":"object","properties":{"valid":{"type":"boolean"},"type":{"type":"string"},"errors":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"detected_fields":{"type":"array","items":{"type":"string"}}},"required":["valid","errors","warnings","detected_fields"]}},"required":["tool","category","result"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"EPS cannot be zero"}},"required":["error","message"]}}}}}}}}}