bitlance-ai-sdk 1.0.0__tar.gz

bitlance_ai_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: bitlance-ai-sdk
+Version: 1.0.0
+Summary: Official Python SDK for the Bitlance SEO/GEO Content Generation API
+Home-page: https://github.com/bitlance/bitlance-ai-python
+Author: Bitlance Automation
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Bitlance AI Python SDK
+
+The official Python SDK for the Bitlance SEO/GEO Content Generation API.
+
+## Installation
+
+```bash
+pip install bitlance-ai-sdk
+```
+
+## Usage
+
+```python
+from bitlance_ai import BitlanceAI
+
+ai = BitlanceAI(api_key="YOUR_API_KEY")
+
+def main():
+    try:
+        # 1. Generate Topics
+        topics = ai.generate_topics(industry="Real Estate", mode="SEO")
+        print("Topics:", topics)
+
+        # 2. Generate SEO Article
+        seo_article = ai.generate_seo({
+            "topic": "How to Invest in Commercial Real Estate in 2026",
+            "keywords": "commercial real estate, investment tips",
+            "length": "Long (1500+ words)"
+        })
+        print("Title:", seo_article.get("title"))
+
+        # 3. Generate GEO Article
+        geo_article = ai.generate_geo({
+            "topic": "Enterprise AI Adoption Maturity Model",
+        })
+        print("Schema:", geo_article.get("schema_markup"))
+
+        # 4. Audit Content
+        audit = ai.audit_content("Your content here...", target_keyword="AI Adoption", mode="GEO")
+        print("Audit:", audit.get("audit_report"))
+
+        # 5. Rewrite Content
+        rewritten = ai.rewrite_content("Your content here...", instructions="Add more hard statistics", mode="GEO")
+        print("Rewritten:", rewritten.get("rewritten_content"))
+
+    except Exception as e:
+        print("Error:", str(e))
+
+if __name__ == "__main__":
+    main()
+```
+
+## Error Handling
+The SDK automatically retries on network failures and `429 Too Many Requests` errors using exponential backoff (up to 3 retries). Client errors like `401 Unauthorized` or `402 Payment Required` will immediately raise a `BitlanceAIError`.

bitlance_ai_sdk-1.0.0/README.md

@@ -0,0 +1,54 @@
+# Bitlance AI Python SDK
+
+The official Python SDK for the Bitlance SEO/GEO Content Generation API.
+
+## Installation
+
+```bash
+pip install bitlance-ai-sdk
+```
+
+## Usage
+
+```python
+from bitlance_ai import BitlanceAI
+
+ai = BitlanceAI(api_key="YOUR_API_KEY")
+
+def main():
+    try:
+        # 1. Generate Topics
+        topics = ai.generate_topics(industry="Real Estate", mode="SEO")
+        print("Topics:", topics)
+
+        # 2. Generate SEO Article
+        seo_article = ai.generate_seo({
+            "topic": "How to Invest in Commercial Real Estate in 2026",
+            "keywords": "commercial real estate, investment tips",
+            "length": "Long (1500+ words)"
+        })
+        print("Title:", seo_article.get("title"))
+
+        # 3. Generate GEO Article
+        geo_article = ai.generate_geo({
+            "topic": "Enterprise AI Adoption Maturity Model",
+        })
+        print("Schema:", geo_article.get("schema_markup"))
+
+        # 4. Audit Content
+        audit = ai.audit_content("Your content here...", target_keyword="AI Adoption", mode="GEO")
+        print("Audit:", audit.get("audit_report"))
+
+        # 5. Rewrite Content
+        rewritten = ai.rewrite_content("Your content here...", instructions="Add more hard statistics", mode="GEO")
+        print("Rewritten:", rewritten.get("rewritten_content"))
+
+    except Exception as e:
+        print("Error:", str(e))
+
+if __name__ == "__main__":
+    main()
+```
+
+## Error Handling
+The SDK automatically retries on network failures and `429 Too Many Requests` errors using exponential backoff (up to 3 retries). Client errors like `401 Unauthorized` or `402 Payment Required` will immediately raise a `BitlanceAIError`.

bitlance_ai_sdk-1.0.0/bitlance_ai/__init__.py

@@ -0,0 +1,108 @@
+import requests
+import time
+from typing import Dict, Any, Optional
+
+class BitlanceAIError(Exception):
+    pass
+
+class BitlanceAI:
+    def __init__(self, api_key: str, base_url: str = "https://api.bitlancetechhub.com/api/v1", max_retries: int = 3, timeout: int = 300):
+        if not api_key:
+            raise ValueError("BitlanceAI: api_key is required")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.max_retries = max_retries
+        self.timeout = timeout
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json"
+        })
+
+    def _request(self, method: str, endpoint: str, json_data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        url = f"{self.base_url}{endpoint}"
+        attempt = 0
+        
+        while attempt < self.max_retries:
+            try:
+                response = self.session.request(method, url, json=json_data, timeout=self.timeout)
+                response.raise_for_status()
+                return response.json()
+            except requests.exceptions.HTTPError as e:
+                attempt += 1
+                status = e.response.status_code
+                # Do not retry client errors except 429
+                if 400 <= status < 500 and status != 429:
+                    raise BitlanceAIError(f"Bitlance API Error ({status}): {e.response.text}")
+                
+                if attempt >= self.max_retries:
+                    raise BitlanceAIError(f"Bitlance API Error: Max retries reached. {str(e)}")
+                    
+            except requests.exceptions.RequestException as e:
+                attempt += 1
+                if attempt >= self.max_retries:
+                    raise BitlanceAIError(f"Bitlance API Error: Max retries reached. {str(e)}")
+                    
+            # Exponential backoff
+            time.sleep(2 ** attempt)
+
+    def generate_topics(self, industry: str, mode: str = "SEO", location: Optional[str] = "Global", goal: Optional[str] = "Lead Generation") -> Dict[str, Any]:
+        if not industry:
+            raise ValueError("industry is required")
+        return self._request("POST", "/topic/generate", {
+            "industry": industry, 
+            "mode": mode,
+            "location": location,
+            "goal": goal
+        })
+
+    def generate_seo(self, params: Dict[str, Any]) -> Dict[str, Any]:
+        if not params.get("topic") and not params.get("industry"):
+            raise ValueError("topic or industry is required")
+        return self._request("POST", "/seo/generate", params)
+
+    def generate_geo(self, params: Dict[str, Any]) -> Dict[str, Any]:
+        if not params.get("topic") and not params.get("industry"):
+            raise ValueError("topic or industry is required")
+        return self._request("POST", "/geo/generate", params)
+
+    def audit_content(self, content: str, target_keyword: Optional[str] = None, mode: str = "SEO") -> Dict[str, Any]:
+        if not content:
+            raise ValueError("content is required")
+        return self._request("POST", "/content/audit", {
+            "content": content,
+            "target_keyword": target_keyword,
+            "mode": mode
+        })
+
+    def rewrite_content(self, content: str, instructions: Optional[str] = None, mode: str = "SEO") -> Dict[str, Any]:
+        if not content:
+            raise ValueError("content is required")
+        return self._request("POST", "/content/rewrite", {
+            "content": content,
+            "instructions": instructions,
+            "mode": mode
+        })
+
+    def track_keyword(self, article_url: str, target_keyword: str, optimization_mode: str = "SEO") -> Dict[str, Any]:
+        return self._request("POST", "/tracking/keywords", {
+            "article_url": article_url,
+            "target_keyword": target_keyword,
+            "optimization_mode": optimization_mode
+        })
+
+    def get_tracked_keywords(self) -> Dict[str, Any]:
+        return self._request("GET", "/tracking/keywords")
+
+    def poll_ai_visibility(self, target_keyword: str, expected_url: str) -> Dict[str, Any]:
+        return self._request("POST", "/tracking/ai-visibility/poll", {
+            "target_keyword": target_keyword,
+            "expected_url": expected_url
+        })
+
+    def predict_traffic(self, search_volume: int, current_position: int, topic_growth_rate: float = 1.0) -> Dict[str, Any]:
+        return self._request("POST", "/tracking/predict-traffic", {
+            "search_volume": search_volume,
+            "current_position": current_position,
+            "topic_growth_rate": topic_growth_rate
+        })

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

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: bitlance-ai-sdk
+Version: 1.0.0
+Summary: Official Python SDK for the Bitlance SEO/GEO Content Generation API
+Home-page: https://github.com/bitlance/bitlance-ai-python
+Author: Bitlance Automation
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Bitlance AI Python SDK
+
+The official Python SDK for the Bitlance SEO/GEO Content Generation API.
+
+## Installation
+
+```bash
+pip install bitlance-ai-sdk
+```
+
+## Usage
+
+```python
+from bitlance_ai import BitlanceAI
+
+ai = BitlanceAI(api_key="YOUR_API_KEY")
+
+def main():
+    try:
+        # 1. Generate Topics
+        topics = ai.generate_topics(industry="Real Estate", mode="SEO")
+        print("Topics:", topics)
+
+        # 2. Generate SEO Article
+        seo_article = ai.generate_seo({
+            "topic": "How to Invest in Commercial Real Estate in 2026",
+            "keywords": "commercial real estate, investment tips",
+            "length": "Long (1500+ words)"
+        })
+        print("Title:", seo_article.get("title"))
+
+        # 3. Generate GEO Article
+        geo_article = ai.generate_geo({
+            "topic": "Enterprise AI Adoption Maturity Model",
+        })
+        print("Schema:", geo_article.get("schema_markup"))
+
+        # 4. Audit Content
+        audit = ai.audit_content("Your content here...", target_keyword="AI Adoption", mode="GEO")
+        print("Audit:", audit.get("audit_report"))
+
+        # 5. Rewrite Content
+        rewritten = ai.rewrite_content("Your content here...", instructions="Add more hard statistics", mode="GEO")
+        print("Rewritten:", rewritten.get("rewritten_content"))
+
+    except Exception as e:
+        print("Error:", str(e))
+
+if __name__ == "__main__":
+    main()
+```
+
+## Error Handling
+The SDK automatically retries on network failures and `429 Too Many Requests` errors using exponential backoff (up to 3 retries). Client errors like `401 Unauthorized` or `402 Payment Required` will immediately raise a `BitlanceAIError`.

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

@@ -0,0 +1,8 @@
+README.md
+setup.py
+bitlance_ai/__init__.py
+bitlance_ai_sdk.egg-info/PKG-INFO
+bitlance_ai_sdk.egg-info/SOURCES.txt
+bitlance_ai_sdk.egg-info/dependency_links.txt
+bitlance_ai_sdk.egg-info/requires.txt
+bitlance_ai_sdk.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+bitlance_ai

bitlance_ai_sdk-1.0.0/setup.cfg

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

bitlance_ai_sdk-1.0.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="bitlance-ai-sdk",
+    version="1.0.0",
+    description="Official Python SDK for the Bitlance SEO/GEO Content Generation API",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="Bitlance Automation",
+    url="https://github.com/bitlance/bitlance-ai-python",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.7",
+)