seoscoreapi 1.0.0__tar.gz

seoscoreapi-1.0.0/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 SEO Score API
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

seoscoreapi-1.0.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: seoscoreapi
+Version: 1.0.0
+Summary: Python client for SEO Score API — audit any URL for SEO issues with one function call
+Author-email: SEO Score API <info@seoscoreapi.com>
+License: MIT
+Project-URL: Homepage, https://seoscoreapi.com
+Project-URL: Documentation, https://seoscoreapi.com/docs
+Project-URL: Repository, https://github.com/SeoScoreAPI/examples
+Keywords: seo,audit,api,seo-score,website-audit,seo-checker
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.20
+Dynamic: license-file
+
+# seoscoreapi
+
+Python client for [SEO Score API](https://seoscoreapi.com) — audit any URL for SEO issues with one function call.
+
+## Install
+
+```bash
+pip install seoscoreapi
+```
+
+## Quick Start
+
+```python
+from seoscoreapi import audit, signup
+
+# Get a free API key (5 audits/day)
+key = signup("you@example.com")
+
+# Audit any URL
+result = audit("https://example.com", api_key=key)
+print(f"Score: {result['score']}/100 ({result['grade']})")
+
+# See what to fix
+for p in result["priorities"]:
+    print(f"  [{p['severity']}] {p['issue']}")
+```
+
+## Functions
+
+| Function | Description |
+|----------|-------------|
+| `signup(email)` | Get a free API key |
+| `audit(url, api_key)` | Run SEO audit on a URL |
+| `batch_audit(urls, api_key)` | Audit multiple URLs (paid) |
+| `usage(api_key)` | Check your usage/limits |
+| `add_monitor(url, api_key)` | Set up score monitoring (paid) |
+| `list_monitors(api_key)` | List active monitors |
+| `report_url(domain)` | Get shareable report URL |
+
+## What Gets Checked
+
+28 checks across 5 categories: meta & content, technical SEO, social/OG, performance, accessibility.
+
+## Links
+
+- [Website & Live Demo](https://seoscoreapi.com)
+- [API Docs](https://seoscoreapi.com/docs)
+- [GitHub Action](https://github.com/SeoScoreAPI/seo-audit-action)

seoscoreapi-1.0.0/README.md

@@ -0,0 +1,48 @@
+# seoscoreapi
+
+Python client for [SEO Score API](https://seoscoreapi.com) — audit any URL for SEO issues with one function call.
+
+## Install
+
+```bash
+pip install seoscoreapi
+```
+
+## Quick Start
+
+```python
+from seoscoreapi import audit, signup
+
+# Get a free API key (5 audits/day)
+key = signup("you@example.com")
+
+# Audit any URL
+result = audit("https://example.com", api_key=key)
+print(f"Score: {result['score']}/100 ({result['grade']})")
+
+# See what to fix
+for p in result["priorities"]:
+    print(f"  [{p['severity']}] {p['issue']}")
+```
+
+## Functions
+
+| Function | Description |
+|----------|-------------|
+| `signup(email)` | Get a free API key |
+| `audit(url, api_key)` | Run SEO audit on a URL |
+| `batch_audit(urls, api_key)` | Audit multiple URLs (paid) |
+| `usage(api_key)` | Check your usage/limits |
+| `add_monitor(url, api_key)` | Set up score monitoring (paid) |
+| `list_monitors(api_key)` | List active monitors |
+| `report_url(domain)` | Get shareable report URL |
+
+## What Gets Checked
+
+28 checks across 5 categories: meta & content, technical SEO, social/OG, performance, accessibility.
+
+## Links
+
+- [Website & Live Demo](https://seoscoreapi.com)
+- [API Docs](https://seoscoreapi.com/docs)
+- [GitHub Action](https://github.com/SeoScoreAPI/seo-audit-action)

seoscoreapi-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "seoscoreapi"
+version = "1.0.0"
+description = "Python client for SEO Score API — audit any URL for SEO issues with one function call"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [{name = "SEO Score API", email = "info@seoscoreapi.com"}]
+dependencies = ["requests>=2.20"]
+keywords = ["seo", "audit", "api", "seo-score", "website-audit", "seo-checker"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://seoscoreapi.com"
+Documentation = "https://seoscoreapi.com/docs"
+Repository = "https://github.com/SeoScoreAPI/examples"

seoscoreapi-1.0.0/seoscoreapi/__init__.py

@@ -0,0 +1,70 @@
+"""
+SEO Score API - Python Client
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Audit any URL for SEO issues with one function call.
+
+Usage:
+    from seoscoreapi import audit, signup
+
+    # Get a free API key
+    key = signup("you@example.com")
+
+    # Run an audit
+    result = audit("https://example.com", api_key=key)
+    print(f"Score: {result['score']}/100 ({result['grade']})")
+
+Full docs: https://seoscoreapi.com/docs
+"""
+
+import requests
+
+BASE_URL = "https://seoscoreapi.com"
+__version__ = "1.0.0"
+
+
+def signup(email: str) -> str:
+    """Sign up for a free API key. Returns the raw key (save it — shown only once)."""
+    r = requests.post(f"{BASE_URL}/signup", json={"email": email})
+    r.raise_for_status()
+    return r.json()["api_key"]
+
+
+def audit(url: str, api_key: str) -> dict:
+    """Run an SEO audit on a URL. Returns score, grade, checks, and priorities."""
+    r = requests.get(f"{BASE_URL}/audit", params={"url": url}, headers={"X-API-Key": api_key})
+    r.raise_for_status()
+    return r.json()
+
+
+def batch_audit(urls: list[str], api_key: str) -> dict:
+    """Audit multiple URLs (paid plans only). Returns list of results."""
+    r = requests.post(f"{BASE_URL}/audit/batch", json={"urls": urls}, headers={"X-API-Key": api_key})
+    r.raise_for_status()
+    return r.json()
+
+
+def usage(api_key: str) -> dict:
+    """Check your API usage and limits."""
+    r = requests.get(f"{BASE_URL}/usage", headers={"X-API-Key": api_key})
+    r.raise_for_status()
+    return r.json()
+
+
+def add_monitor(url: str, api_key: str, frequency: str = "daily") -> dict:
+    """Set up score monitoring for a URL (paid plans only)."""
+    r = requests.post(f"{BASE_URL}/monitors", json={"url": url, "frequency": frequency}, headers={"X-API-Key": api_key})
+    r.raise_for_status()
+    return r.json()
+
+
+def list_monitors(api_key: str) -> list:
+    """List your active monitors."""
+    r = requests.get(f"{BASE_URL}/monitors", headers={"X-API-Key": api_key})
+    r.raise_for_status()
+    return r.json()["monitors"]
+
+
+def report_url(domain: str) -> str:
+    """Get the shareable report URL for a domain."""
+    return f"{BASE_URL}/report/{domain}"

seoscoreapi-1.0.0/seoscoreapi.egg-info/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: seoscoreapi
+Version: 1.0.0
+Summary: Python client for SEO Score API — audit any URL for SEO issues with one function call
+Author-email: SEO Score API <info@seoscoreapi.com>
+License: MIT
+Project-URL: Homepage, https://seoscoreapi.com
+Project-URL: Documentation, https://seoscoreapi.com/docs
+Project-URL: Repository, https://github.com/SeoScoreAPI/examples
+Keywords: seo,audit,api,seo-score,website-audit,seo-checker
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.20
+Dynamic: license-file
+
+# seoscoreapi
+
+Python client for [SEO Score API](https://seoscoreapi.com) — audit any URL for SEO issues with one function call.
+
+## Install
+
+```bash
+pip install seoscoreapi
+```
+
+## Quick Start
+
+```python
+from seoscoreapi import audit, signup
+
+# Get a free API key (5 audits/day)
+key = signup("you@example.com")
+
+# Audit any URL
+result = audit("https://example.com", api_key=key)
+print(f"Score: {result['score']}/100 ({result['grade']})")
+
+# See what to fix
+for p in result["priorities"]:
+    print(f"  [{p['severity']}] {p['issue']}")
+```
+
+## Functions
+
+| Function | Description |
+|----------|-------------|
+| `signup(email)` | Get a free API key |
+| `audit(url, api_key)` | Run SEO audit on a URL |
+| `batch_audit(urls, api_key)` | Audit multiple URLs (paid) |
+| `usage(api_key)` | Check your usage/limits |
+| `add_monitor(url, api_key)` | Set up score monitoring (paid) |
+| `list_monitors(api_key)` | List active monitors |
+| `report_url(domain)` | Get shareable report URL |
+
+## What Gets Checked
+
+28 checks across 5 categories: meta & content, technical SEO, social/OG, performance, accessibility.
+
+## Links
+
+- [Website & Live Demo](https://seoscoreapi.com)
+- [API Docs](https://seoscoreapi.com/docs)
+- [GitHub Action](https://github.com/SeoScoreAPI/seo-audit-action)

seoscoreapi-1.0.0/seoscoreapi.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+seoscoreapi/__init__.py
+seoscoreapi.egg-info/PKG-INFO
+seoscoreapi.egg-info/SOURCES.txt
+seoscoreapi.egg-info/dependency_links.txt
+seoscoreapi.egg-info/requires.txt
+seoscoreapi.egg-info/top_level.txt

seoscoreapi-1.0.0/seoscoreapi.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

seoscoreapi-1.0.0/seoscoreapi.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.20

seoscoreapi-1.0.0/seoscoreapi.egg-info/top_level.txt

@@ -0,0 +1 @@
+seoscoreapi

seoscoreapi-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+