Gstaccelerator Js

极速、异步优先的 HSN/SAC 税率查询与 GSTIN 验证工具，适用于印度企业级 B2B 平台。原生支持 Model Context Protocol (MCP)，可让 AI Agent 即时连接印度实时税务数据。

---

⚡ 主要功能

专为现代金融科技平台和高吞吐量企业系统所需的规模与可靠性而构建。

• 🚀 极速且异步优先： 非阻塞 API 请求，专为极高并发和低延迟环境而设计。
• 🛡️ 企业级可靠性： 内置连接池、指数退避机制，以及针对速率限制或未激活/被封锁 GSTIN 的健壮错误处理。
• 🤖 零配置 MCP 服务： 原生集成 AI Agent（Claude Desktop、Cursor、Windsurf）。让大模型即时安全地访问实时税率信息。
• 🇮🇳 全面合规： 始终根据 CBIC 最新税率通知更新（包括 GST 2.0）。
• 🧩 双 SDK： 同时提供 Python（PyPI）和 Node.js/TypeScript（npm）版本。

---

📦 安装

在首选环境中安装该库：

Python 3.10+

pip install gstaccelerator

Node.js（支持 TypeScript）

npm install gstaccelerator

---

🚀 双模式快速入门

1. 标准 SDK 用法

在应用中无缝获取精确税务详情，或通过 GSTIN 验证企业身份。

Python（asyncio）

import asyncio
from gstaccelerator import GSTClient

async def check_gstin():
    # Initialize client with your API key
    client = GSTClient(api_key="your_api_key_here")
    
    try:
        # Fetch high-speed GSTIN details
        business = await client.get_gstin_details("27AADCB2230M1Z2")
        print(f"Business Name: {business.legal_name}")
        print(f"Status: {business.status}") # e.g., 'Active'
    finally:
        await client.close()

asyncio.run(check_gstin())

TypeScript / Node.js

import { GSTClient } from 'gstaccelerator';

async function checkGstin() {
    // Initialize client with your API key
    const client = new GSTClient({ apiKey: "your_api_key_here" });
    
    try:
        // Fetch high-speed GSTIN details
        const business = await client.getGstinDetails("27AADCB2230M1Z2");
        console.log(`Business Name: ${business.legalName}`);
        console.log(`Status: ${business.status}`);
    } finally {
        await client.close();
    }
}

checkGstin();

2. MCP 服务配置（面向 AI Agent）

你可以将 gstaccelerator 挂载为原生 MCP 服务，让 AI 模型在 Agent 工作流中直接查询 GST 和 HSN 税率。

将以下代码块添加到 claude_desktop_config.json（或 Cursor/Windsurf 配置文件）中：

{
  "mcpServers": {
    "gstaccelerator": {
      "command": "npx",
      "args": [
        "-y",
        "gstaccelerator",
        "mcp"
      ],
      "env": {
        "GST_API_KEY": "your_api_key_here"
      }
    }
  }
}

（对应的 Python 命令："command": "gstaccelerator-mcp"）

---

🛑 错误处理

企业系统需要结构化、可预测的故障。SDK 会针对边缘情况抛出清晰、类型明确的异常，而不是静默失败或原始 HTTP 响应。

from gstaccelerator.exceptions import InvalidGSTINError, RateLimitError

try:
    data = await client.get_gstin_details("INVALID123")
except InvalidGSTINError as e:
    print(f"Validation failed: {e.message}") # The GSTIN format is invalid
except RateLimitError as e:
    print(f"Throttled! Retry after {e.retry_after} seconds.")
except Exception as e:
    print("An unexpected network error occurred.")

---

🔗 链接

• 网站与控制台： gstaccelerator.in
• 文档： docs.gstaccelerator.in
• Python 仓库： github.com/thedivine1/gstaccelerator-python
• Node 仓库： github.com/thedivine1/gstaccelerator-js