groundapi-cli 1.0.0__py3-none-any.whl

cli/main.py

@@ -0,0 +1,262 @@
+"""
+GroundAPI CLI — A股行情、天气、汇率、快递、搜索、短信、网页抓取、邮件、IP定位
+安装后使用: groundapi <command> <args>
+"""
+
+import json
+import os
+import sys
+from pathlib import Path
+
+import httpx
+import typer
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+from rich import print as rprint
+
+app = typer.Typer(
+    name="groundapi",
+    help="GroundAPI CLI — Real-time Data API for AI Agents",
+    no_args_is_help=True,
+)
+console = Console()
+
+CONFIG_DIR = Path.home() / ".groundapi"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+API_BASE = os.getenv("GROUNDAPI_BASE_URL", "https://api.groundapi.net")
+
+
+def _load_config() -> dict:
+    if CONFIG_FILE.exists():
+        return json.loads(CONFIG_FILE.read_text())
+    return {}
+
+
+def _save_config(data: dict):
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(data, indent=2))
+
+
+def _get_api_key() -> str:
+    key = os.getenv("GROUNDAPI_API_KEY") or _load_config().get("api_key", "")
+    if not key:
+        console.print("[red]未设置 API Key。请先运行: groundapi config set-key <your-key>[/red]")
+        raise typer.Exit(1)
+    return key
+
+
+def _call(path: str, params: dict) -> dict:
+    api_key = _get_api_key()
+    try:
+        resp = httpx.get(
+            f"{API_BASE}{path}",
+            params=params,
+            headers={"X-API-Key": api_key},
+            timeout=30,
+        )
+        return resp.json()
+    except httpx.HTTPError as e:
+        console.print(f"[red]请求失败: {e}[/red]")
+        raise typer.Exit(1)
+
+
+def _print_result(data: dict):
+    if not data.get("success"):
+        err = data.get("error", {})
+        console.print(f"[red]错误 [{err.get('code', 'UNKNOWN')}]: {err.get('message', '未知错误')}[/red]")
+        if err.get("docs"):
+            console.print(f"[dim]文档: {err['docs']}[/dim]")
+        raise typer.Exit(1)
+
+    rprint(Panel(json.dumps(data["data"], indent=2, ensure_ascii=False), title="结果", border_style="blue"))
+
+
+# ─── config ─────────────────────────────────────────────
+
+config_app = typer.Typer(help="配置管理")
+app.add_typer(config_app, name="config")
+
+
+@config_app.command("set-key")
+def config_set_key(api_key: str = typer.Argument(..., help="你的 GroundAPI API Key")):
+    """保存 API Key 到本地配置"""
+    cfg = _load_config()
+    cfg["api_key"] = api_key
+    _save_config(cfg)
+    console.print(f"[green]API Key 已保存到 {CONFIG_FILE}[/green]")
+
+
+@config_app.command("show")
+def config_show():
+    """显示当前配置"""
+    cfg = _load_config()
+    if cfg.get("api_key"):
+        key = cfg["api_key"]
+        masked = key[:12] + "..." + key[-4:] if len(key) > 16 else "***"
+        console.print(f"API Key: {masked}")
+    else:
+        console.print("[yellow]未设置 API Key[/yellow]")
+    console.print(f"API Base: {API_BASE}")
+
+
+# ─── stock ──────────────────────────────────────────────
+
+@app.command()
+def stock(
+    symbol: str = typer.Argument(..., help="股票代码，如 600519"),
+):
+    """查询 A 股实时行情"""
+    result = _call("/v1/stock/quote", {"symbol": symbol})
+    if result.get("success"):
+        d = result["data"]
+        table = Table(title=f"{d.get('name', symbol)} ({symbol})")
+        table.add_column("指标", style="cyan")
+        table.add_column("值", style="bold")
+        table.add_row("当前价", str(d.get("price", "-")))
+        table.add_row("涨跌额", str(d.get("change", "-")))
+        table.add_row("涨跌幅", f"{d.get('change_percent', '-')}%")
+        table.add_row("开盘", str(d.get("open", "-")))
+        table.add_row("最高", str(d.get("high", "-")))
+        table.add_row("最低", str(d.get("low", "-")))
+        table.add_row("成交量", str(d.get("volume", "-")))
+        console.print(table)
+    else:
+        _print_result(result)
+
+
+# ─── weather ────────────────────────────────────────────
+
+@app.command()
+def weather(
+    city: str = typer.Argument(..., help="城市名称，如 北京、Tokyo"),
+):
+    """查询实时天气"""
+    result = _call("/v1/weather/current", {"city": city})
+    _print_result(result)
+
+
+# ─── forex ──────────────────────────────────────────────
+
+@app.command()
+def forex(
+    from_currency: str = typer.Argument(..., help="源货币，如 USD"),
+    to_currency: str = typer.Argument(..., help="目标货币，如 CNY"),
+):
+    """查询实时汇率"""
+    result = _call("/v1/forex/rate", {"from": from_currency, "to": to_currency})
+    if result.get("success"):
+        d = result["data"]
+        console.print(
+            f"[bold]1 {d.get('from', from_currency)} = {d.get('rate', '?')} {d.get('to', to_currency)}[/bold]"
+        )
+    else:
+        _print_result(result)
+
+
+# ─── logistics ──────────────────────────────────────────
+
+@app.command()
+def logistics(
+    number: str = typer.Argument(..., help="快递运单号"),
+    carrier: str = typer.Option("", help="快递公司编码，如 sf、yd，不填自动识别"),
+):
+    """追踪快递物流"""
+    params: dict = {"number": number}
+    if carrier:
+        params["carrier"] = carrier
+    result = _call("/v1/logistics/track", params)
+    if result.get("success"):
+        d = result["data"]
+        console.print(f"[bold]{d.get('carrier_name', '')}[/bold] — {d.get('status_text', '')}")
+        for track in d.get("tracks", []):
+            console.print(f"  [dim]{track.get('time', '')}[/dim] {track.get('description', '')}")
+    else:
+        _print_result(result)
+
+
+# ─── search ────────────────────────────────────────────
+
+@app.command()
+def search(
+    query: str = typer.Argument(..., help="搜索关键词"),
+    engine: str = typer.Option("pro", help="搜索引擎：std/pro/sogou/quark"),
+    count: int = typer.Option(10, help="返回结果数量，1-50"),
+    recency: str = typer.Option("noLimit", help="时间范围：oneDay/oneWeek/oneMonth/oneYear/noLimit"),
+):
+    """网络搜索"""
+    result = _call("/v1/search/query", {"q": query, "engine": engine, "count": count, "recency": recency})
+    if result.get("success"):
+        d = result["data"]
+        console.print(f"[bold]搜索: {d.get('query', query)}[/bold] — {d.get('result_count', 0)} 条结果\n")
+        for i, item in enumerate(d.get("results", []), 1):
+            console.print(f"[cyan]{i}.[/cyan] [bold]{item.get('title', '')}[/bold]")
+            console.print(f"   [blue underline]{item.get('link', '')}[/blue underline]")
+            snippet = item.get("snippet", "")
+            if snippet:
+                console.print(f"   [dim]{snippet[:200]}[/dim]")
+            source = item.get("source", "")
+            date = item.get("publish_date", "")
+            if source or date:
+                console.print(f"   [dim]{source}  {date}[/dim]")
+            console.print()
+    else:
+        _print_result(result)
+
+
+# ─── scrape ────────────────────────────────────────────
+
+@app.command()
+def scrape(
+    url: str = typer.Argument(..., help="要抓取的网页 URL"),
+    format: str = typer.Option("markdown", help="返回格式：markdown 或 text"),
+    max_lines: int = typer.Option(50, help="终端显示最大行数"),
+):
+    """抓取网页内容"""
+    result = _call("/v1/scrape/read", {"url": url, "format": format})
+    if result.get("success"):
+        d = result["data"]
+        title = d.get("title", "")
+        if title:
+            console.print(f"[bold]{title}[/bold]\n")
+        console.print(f"[dim]URL: {d.get('url', url)} | {d.get('content_length', 0)} 字符[/dim]\n")
+        content = d.get("content", "")
+        lines = content.split("\n")
+        if len(lines) > max_lines:
+            console.print("\n".join(lines[:max_lines]))
+            console.print(f"\n[dim]... 还有 {len(lines) - max_lines} 行，使用 --max-lines 查看更多[/dim]")
+        else:
+            console.print(content)
+    else:
+        _print_result(result)
+
+
+# ─── ip ────────────────────────────────────────────────
+
+@app.command()
+def ip(
+    address: str = typer.Argument(..., help="要查询的 IP 地址，如 8.8.8.8"),
+):
+    """IP 地理定位"""
+    result = _call("/v1/ip/locate", {"ip": address})
+    if result.get("success"):
+        d = result["data"]
+        table = Table(title=f"IP 定位: {d.get('ip', address)}")
+        table.add_column("属性", style="cyan")
+        table.add_column("值", style="bold")
+        table.add_row("国家", f"{d.get('country', '')} ({d.get('country_code', '')})")
+        table.add_row("地区", d.get("region", ""))
+        table.add_row("城市", d.get("city", ""))
+        table.add_row("邮编", d.get("zip", ""))
+        table.add_row("经纬度", f"{d.get('latitude', '')}, {d.get('longitude', '')}")
+        table.add_row("时区", d.get("timezone", ""))
+        table.add_row("ISP", d.get("isp", ""))
+        table.add_row("组织", d.get("org", ""))
+        console.print(table)
+    else:
+        _print_result(result)
+
+
+if __name__ == "__main__":
+    app()

groundapi_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,52 @@
+Metadata-Version: 2.2
+Name: groundapi-cli
+Version: 1.0.0
+Summary: GroundAPI CLI — Real-time Data API for AI Agents
+Project-URL: Homepage, https://groundapi.net
+Project-URL: Documentation, https://groundapi.net/documentation
+Keywords: groundapi,cli,api,ai-agent,real-time-data
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: typer>=0.15.0
+Requires-Dist: rich>=13.9.0
+
+# GroundAPI CLI
+
+专为 AI Agent 设计的实时数据命令行工具。一个 API Key，在终端查询 A 股行情、天气、汇率、快递、搜索、网页抓取、IP 定位。
+
+## 安装
+
+```bash
+pip install groundapi-cli
+```
+
+## 配置
+
+```bash
+groundapi config set-key sk_gapi_你的密钥
+```
+
+或使用环境变量：
+
+```bash
+export GROUNDAPI_API_KEY=sk_gapi_你的密钥
+```
+
+## 使用
+
+```bash
+groundapi stock 600519          # A 股实时行情
+groundapi weather 北京          # 天气查询
+groundapi forex USD CNY         # 汇率查询
+groundapi logistics SF1234567   # 快递追踪
+groundapi search "AI Agent"     # 网络搜索
+groundapi scrape https://...    # 网页抓取
+groundapi ip 8.8.8.8            # IP 定位
+```
+
+## 获取 API Key
+
+前往 [groundapi.net](https://groundapi.net) 注册，每月 500 次免费调用。

groundapi_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/main.py,sha256=_OsEcllgK4q3A37RFZJJCrfQ2ZIWOHzLmgJGtedORu0,9718
+groundapi_cli-1.0.0.dist-info/METADATA,sha256=Cy8sBLnS0qdD4meTYb3kx0n7BX2fkspxVYnPsMs_CBw,1374
+groundapi_cli-1.0.0.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
+groundapi_cli-1.0.0.dist-info/entry_points.txt,sha256=bAwifWg6gywgBNwM1IyejBbYjA9WloVMyKxaVikSgv4,43
+groundapi_cli-1.0.0.dist-info/top_level.txt,sha256=2ImG917oaVHlm0nP9oJE-Qrgs-fq_fGWgba2H1f8fpE,4
+groundapi_cli-1.0.0.dist-info/RECORD,,

groundapi_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (76.1.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

groundapi_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+groundapi = cli.main:app

groundapi_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cli