agentberlin 0.4.0__tar.gz

agentberlin-0.4.0/.gitignore

@@ -0,0 +1,77 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# uv
+uv.lock
+.python-version

agentberlin-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Agent Berlin
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentberlin-0.4.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: agentberlin
+Version: 0.4.0
+Summary: Python SDK for Agent Berlin - AI-powered SEO and AEO automation
+Project-URL: Homepage, https://agentberlin.ai
+Project-URL: Documentation, https://docs.agentberlin.ai/sdk/python
+Project-URL: Repository, https://github.com/boat-builder/berlin
+Author-email: Agent Berlin <support@agentberlin.ai>
+License: MIT
+License-File: LICENSE
+Keywords: aeo,ai,analytics,optimization,search,seo
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0.0; extra == 'dev'
+Requires-Dist: isort>=5.13.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: responses>=0.25.0; extra == 'dev'
+Requires-Dist: types-requests>=2.31.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Agent Berlin Python SDK
+
+Official Python SDK for Agent Berlin - AI-powered SEO and AEO automation.
+
+## Installation
+
+```bash
+pip install agentberlin
+```
+
+## Quick Start
+
+```python
+from agentberlin import AgentBerlin
+
+# Set your API token as an environment variable
+# export AGENTBERLIN_TOKEN="your-token-here"
+
+client = AgentBerlin()
+
+# Get analytics for your project
+analytics = client.analytics.get(project_domain="example.com")
+print(f"Visibility: {analytics.visibility.current_percentage}%")
+print(f"LLM Sessions: {analytics.traffic.llm_sessions}")
+
+# Search for pages
+pages = client.pages.search(
+    project_domain="example.com",
+    query="SEO best practices",
+    limit=10
+)
+for page in pages.pages:
+    print(f"  - {page.title}: {page.url}")
+
+# Search for keywords
+keywords = client.keywords.search(
+    project_domain="example.com",
+    query="digital marketing"
+)
+for kw in keywords.keywords:
+    print(f"  - {kw.keyword} (volume: {kw.volume})")
+
+# Get page details
+page = client.pages.get(
+    project_domain="example.com",
+    url="https://example.com/blog/seo-tips"
+)
+print(f"Title: {page.title}")
+print(f"H1: {page.h1}")
+
+# Get brand profile
+profile = client.brand.get_profile(project_domain="example.com")
+print(f"Domain Authority: {profile.domain_authority}")
+
+# Update brand profile
+client.brand.update_profile(
+    project_domain="example.com",
+    field="competitors",
+    value="competitor.com",
+    mode="add"
+)
+
+# Fetch SERP results
+serp = client.serp.fetch(query="best seo tools", max_results=5)
+for result in serp.results:
+    print(f"  - {result.title}: {result.url}")
+```
+
+## Authentication
+
+The SDK requires an API token. Set it as an environment variable:
+
+```bash
+export AGENTBERLIN_TOKEN="your-token-here"
+```
+
+Or pass it directly:
+
+```python
+client = AgentBerlin(token="your-token-here")
+```
+
+## Configuration
+
+```python
+client = AgentBerlin(
+    token="your-token",           # Optional if AGENTBERLIN_TOKEN env var is set
+    base_url="https://...",       # Optional, defaults to production API
+    timeout=30,                   # Request timeout in seconds
+)
+```
+
+## Resources
+
+### Analytics
+```python
+client.analytics.get(project_domain="example.com")
+```
+
+### Pages
+```python
+client.pages.search(project_domain, query, domain=None, limit=10, status_code=None, topic=None, page_type=None)
+client.pages.get(project_domain, url, content_length=0)
+```
+
+### Keywords
+```python
+client.keywords.search(project_domain, query, limit=10)
+```
+
+### Brand
+```python
+client.brand.get_profile(project_domain)
+client.brand.update_profile(project_domain, field, value, mode="add")
+```
+
+### SERP
+```python
+client.serp.fetch(query, max_results=10, country=None, language=None)
+```
+
+## Error Handling
+
+```python
+from agentberlin import AgentBerlin
+from agentberlin.exceptions import (
+    AgentBerlinError,
+    AgentBerlinAuthenticationError,
+    AgentBerlinNotFoundError,
+    AgentBerlinRateLimitError,
+)
+
+client = AgentBerlin()
+
+try:
+    analytics = client.analytics.get(project_domain="example.com")
+except AgentBerlinAuthenticationError:
+    print("Invalid or missing API token")
+except AgentBerlinNotFoundError:
+    print("Domain not found")
+except AgentBerlinRateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except AgentBerlinError as e:
+    print(f"API error: {e.message}")
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

agentberlin-0.4.0/README.md

@@ -0,0 +1,149 @@
+# Agent Berlin Python SDK
+
+Official Python SDK for Agent Berlin - AI-powered SEO and AEO automation.
+
+## Installation
+
+```bash
+pip install agentberlin
+```
+
+## Quick Start
+
+```python
+from agentberlin import AgentBerlin
+
+# Set your API token as an environment variable
+# export AGENTBERLIN_TOKEN="your-token-here"
+
+client = AgentBerlin()
+
+# Get analytics for your project
+analytics = client.analytics.get(project_domain="example.com")
+print(f"Visibility: {analytics.visibility.current_percentage}%")
+print(f"LLM Sessions: {analytics.traffic.llm_sessions}")
+
+# Search for pages
+pages = client.pages.search(
+    project_domain="example.com",
+    query="SEO best practices",
+    limit=10
+)
+for page in pages.pages:
+    print(f"  - {page.title}: {page.url}")
+
+# Search for keywords
+keywords = client.keywords.search(
+    project_domain="example.com",
+    query="digital marketing"
+)
+for kw in keywords.keywords:
+    print(f"  - {kw.keyword} (volume: {kw.volume})")
+
+# Get page details
+page = client.pages.get(
+    project_domain="example.com",
+    url="https://example.com/blog/seo-tips"
+)
+print(f"Title: {page.title}")
+print(f"H1: {page.h1}")
+
+# Get brand profile
+profile = client.brand.get_profile(project_domain="example.com")
+print(f"Domain Authority: {profile.domain_authority}")
+
+# Update brand profile
+client.brand.update_profile(
+    project_domain="example.com",
+    field="competitors",
+    value="competitor.com",
+    mode="add"
+)
+
+# Fetch SERP results
+serp = client.serp.fetch(query="best seo tools", max_results=5)
+for result in serp.results:
+    print(f"  - {result.title}: {result.url}")
+```
+
+## Authentication
+
+The SDK requires an API token. Set it as an environment variable:
+
+```bash
+export AGENTBERLIN_TOKEN="your-token-here"
+```
+
+Or pass it directly:
+
+```python
+client = AgentBerlin(token="your-token-here")
+```
+
+## Configuration
+
+```python
+client = AgentBerlin(
+    token="your-token",           # Optional if AGENTBERLIN_TOKEN env var is set
+    base_url="https://...",       # Optional, defaults to production API
+    timeout=30,                   # Request timeout in seconds
+)
+```
+
+## Resources
+
+### Analytics
+```python
+client.analytics.get(project_domain="example.com")
+```
+
+### Pages
+```python
+client.pages.search(project_domain, query, domain=None, limit=10, status_code=None, topic=None, page_type=None)
+client.pages.get(project_domain, url, content_length=0)
+```
+
+### Keywords
+```python
+client.keywords.search(project_domain, query, limit=10)
+```
+
+### Brand
+```python
+client.brand.get_profile(project_domain)
+client.brand.update_profile(project_domain, field, value, mode="add")
+```
+
+### SERP
+```python
+client.serp.fetch(query, max_results=10, country=None, language=None)
+```
+
+## Error Handling
+
+```python
+from agentberlin import AgentBerlin
+from agentberlin.exceptions import (
+    AgentBerlinError,
+    AgentBerlinAuthenticationError,
+    AgentBerlinNotFoundError,
+    AgentBerlinRateLimitError,
+)
+
+client = AgentBerlin()
+
+try:
+    analytics = client.analytics.get(project_domain="example.com")
+except AgentBerlinAuthenticationError:
+    print("Invalid or missing API token")
+except AgentBerlinNotFoundError:
+    print("Domain not found")
+except AgentBerlinRateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except AgentBerlinError as e:
+    print(f"API error: {e.message}")
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

agentberlin-0.4.0/pyproject.toml

@@ -0,0 +1,75 @@
+[project]
+name = "agentberlin"
+version = "0.4.0"
+description = "Python SDK for Agent Berlin - AI-powered SEO and AEO automation"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Agent Berlin", email = "support@agentberlin.ai"}
+]
+keywords = ["seo", "aeo", "ai", "search", "optimization", "analytics"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+dependencies = [
+    "requests>=2.28.0",
+    "pydantic>=2.0.0",
+]
+
+[project.urls]
+Homepage = "https://agentberlin.ai"
+Documentation = "https://docs.agentberlin.ai/sdk/python"
+Repository = "https://github.com/boat-builder/berlin"
+
+[build-system]
+requires = ["hatchling>=1.20.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentberlin"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "0.4.0"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[project.optional-dependencies]
+dev = [
+    "black>=24.0.0",
+    "isort>=5.13.0",
+    "mypy>=1.8.0",
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "responses>=0.25.0",
+    "types-requests>=2.31.0",
+]

agentberlin-0.4.0/src/agentberlin/__init__.py

@@ -0,0 +1,51 @@
+"""Agent Berlin Python SDK.
+
+A Python SDK for Agent Berlin - AI-powered SEO and AEO automation.
+
+Example:
+    from agentberlin import AgentBerlin
+
+    # Set AGENTBERLIN_TOKEN environment variable or pass token directly
+    client = AgentBerlin()
+
+    # Get analytics
+    analytics = client.analytics.get(project_domain="example.com")
+
+    # Search pages
+    pages = client.pages.search(project_domain="example.com", query="SEO tips")
+
+    # Search keywords
+    keywords = client.keywords.search(project_domain="example.com", query="marketing")
+
+    # Get brand profile
+    profile = client.brand.get_profile(project_domain="example.com")
+
+    # Fetch SERP results
+    serp = client.serp.fetch(query="best seo tools")
+"""
+
+from .client import AgentBerlin
+from .exceptions import (
+    AgentBerlinAPIError,
+    AgentBerlinAuthenticationError,
+    AgentBerlinConnectionError,
+    AgentBerlinError,
+    AgentBerlinNotFoundError,
+    AgentBerlinRateLimitError,
+    AgentBerlinServerError,
+    AgentBerlinValidationError,
+)
+
+__version__ = "0.4.0"
+
+__all__ = [
+    "AgentBerlin",
+    "AgentBerlinError",
+    "AgentBerlinAuthenticationError",
+    "AgentBerlinAPIError",
+    "AgentBerlinNotFoundError",
+    "AgentBerlinRateLimitError",
+    "AgentBerlinServerError",
+    "AgentBerlinValidationError",
+    "AgentBerlinConnectionError",
+]