{"id":51026664,"url":"https://github.com/gitstq/ipinfo-cli","last_synced_at":"2026-06-21T20:02:11.202Z","repository":{"id":362016807,"uuid":"1256893556","full_name":"gitstq/ipinfo-cli","owner":"gitstq","description":"🔍 A modern CLI tool for IP address information lookup","archived":false,"fork":false,"pushed_at":"2026-06-02T07:15:50.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T09:12:27.100Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-02T07:14:33.000Z","updated_at":"2026-06-02T07:15:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/ipinfo-cli","commit_stats":null,"previous_names":["gitstq/ipinfo-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/ipinfo-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fipinfo-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fipinfo-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fipinfo-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fipinfo-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/ipinfo-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fipinfo-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:10.435Z","updated_at":"2026-06-21T20:02:11.181Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🔍 IPInfo CLI\n\n**A Modern Command-Line Tool for IP Address Information Lookup**\n\n[![Python](https://img.shields.io/badge/Python-3.8%2B-blue?logo=python\u0026logoColor=white)](https://www.python.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/Version-1.0.0-orange.svg)](https://github.com/gitstq/ipinfo-cli)\n\n**🌍 Languages / 语言 / 語言**\n\n[English](#-english) | [简体中文](#-简体中文) | [繁體中文](#-繁體中文)\n\n---\n\n\u003c/div\u003e\n\n---\n\n## 🇬🇧 English\n\n### 🎉 Introduction\n\n**IPInfo CLI** is a lightweight, modern command-line tool for retrieving detailed information about IP addresses. Whether you're a developer, system administrator, or security professional, this tool provides quick and accurate IP geolocation, ISP details, and network information right from your terminal.\n\n**Key Highlights:**\n- 🚀 **Fast \u0026 Lightweight** - Get results in milliseconds\n- 🎨 **Beautiful Output** - Rich, colorful terminal display\n- 📊 **Multiple Formats** - Table, JSON, or compact output\n- 🔒 **Privacy Focused** - No data collection, uses public APIs\n- 🌐 **IPv4 \u0026 IPv6** - Full support for both protocols\n\n### ✨ Core Features\n\n| Feature | Description |\n|---------|-------------|\n| 🔍 **IP Lookup** | Query any public IP address for detailed information |\n| 📍 **Geolocation** | Get city, region, country, and coordinates |\n| 🏢 **Organization** | View ISP and organization details |\n| ⏰ **Timezone** | Display timezone information |\n| 📋 **JSON Export** | Export data in JSON format for scripting |\n| 🎯 **Self IP** | Quickly check your own public IP |\n\n### 🚀 Quick Start\n\n#### Requirements\n- Python 3.8 or higher\n- pip (Python package manager)\n\n#### Installation\n\n```bash\n# Install from PyPI (recommended)\npip install ipinfo-cli\n\n# Or install from source\ngit clone https://github.com/gitstq/ipinfo-cli.git\ncd ipinfo-cli\npip install -e .\n```\n\n#### Usage\n\n```bash\n# Check your public IP\nipinfo\n\n# Look up a specific IP address\nipinfo 8.8.8.8\n\n# Output as JSON\nipinfo 8.8.8.8 --json\n\n# Compact output\nipinfo 8.8.8.8 --compact\n\n# Show version\nipinfo --version\n```\n\n### 📖 Detailed Usage Guide\n\n#### Basic Commands\n\n```bash\n# Get your public IP information\n$ ipinfo\n\n🔍 IP Information: 203.0.113.45\n┌─────────────────┬──────────────────────────────┐\n│ Field           │ Value                        │\n├─────────────────┼──────────────────────────────┤\n│ 🌐 IP Address   │ 203.0.113.45                 │\n│ 🏙️ City         │ San Francisco                │\n│ 📍 Region       │ California                   │\n│ 🌍 Country      │ United States                │\n│ 🏢 Organization │ Example ISP Inc.             │\n│ ⏰ Timezone     │ America/Los_Angeles          │\n└─────────────────┴──────────────────────────────┘\n```\n\n#### JSON Output (Perfect for Scripts)\n\n```bash\n$ ipinfo 1.1.1.1 -j\n\n{\n  \"ip\": \"1.1.1.1\",\n  \"hostname\": \"one.one.one.one\",\n  \"city\": \"Sydney\",\n  \"region\": \"New South Wales\",\n  \"country\": \"Australia\",\n  \"location\": \"-33.8688,151.2093\",\n  \"organization\": \"Cloudflare, Inc.\",\n  \"timezone\": \"Australia/Sydney\"\n}\n```\n\n#### Use Cases\n\n1. **Network Debugging** - Quickly identify IP-related issues\n2. **Security Analysis** - Investigate suspicious IP addresses\n3. **Automation Scripts** - Parse JSON output in your scripts\n4. **Geolocation Services** - Get location data for applications\n5. **DevOps** - Monitor and log IP information in pipelines\n\n### 💡 Design Philosophy\n\nIPInfo CLI was designed with simplicity and efficiency in mind:\n- **Minimal Dependencies** - Only essential packages required\n- **Cross-Platform** - Works on Windows, macOS, and Linux\n- **API Fallback** - Multiple API sources for reliability\n- **Clean Code** - Well-documented, type-hinted Python code\n\n### 📦 Packaging \u0026 Deployment\n\n```bash\n# Build the package\npip install build\npython -m build\n\n# The distribution files will be in dist/\n```\n\n### 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'feat: add some amazing feature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n### 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🇨🇳 简体中文\n\n### 🎉 项目介绍\n\n**IPInfo CLI** 是一款轻量级、现代化的命令行工具，用于查询IP地址的详细信息。无论您是开发者、系统管理员还是安全专业人员，这款工具都能在终端中快速准确地提供IP地理位置、ISP详情和网络信息。\n\n**核心亮点：**\n- 🚀 **快速轻量** - 毫秒级响应\n- 🎨 **美观输出** - 丰富多彩的终端显示\n- 📊 **多种格式** - 支持表格、JSON或紧凑输出\n- 🔒 **隐私优先** - 不收集数据，使用公共API\n- 🌐 **IPv4 \u0026 IPv6** - 完整支持两种协议\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 🔍 **IP查询** | 查询任意公网IP地址的详细信息 |\n| 📍 **地理位置** | 获取城市、地区、国家和坐标 |\n| 🏢 **组织信息** | 查看ISP和组织详情 |\n| ⏰ **时区信息** | 显示时区数据 |\n| 📋 **JSON导出** | 导出JSON格式数据用于脚本 |\n| 🎯 **本机IP** | 快速查看自己的公网IP |\n\n### 🚀 快速开始\n\n#### 环境要求\n- Python 3.8 或更高版本\n- pip（Python包管理器）\n\n#### 安装方式\n\n```bash\n# 从PyPI安装（推荐）\npip install ipinfo-cli\n\n# 或从源码安装\ngit clone https://github.com/gitstq/ipinfo-cli.git\ncd ipinfo-cli\npip install -e .\n```\n\n#### 使用方法\n\n```bash\n# 查看您的公网IP\nipinfo\n\n# 查询特定IP地址\nipinfo 8.8.8.8\n\n# JSON格式输出\nipinfo 8.8.8.8 --json\n\n# 紧凑格式输出\nipinfo 8.8.8.8 --compact\n\n# 显示版本\nipinfo --version\n```\n\n### 📖 详细使用指南\n\n#### 基本命令\n\n```bash\n# 获取您的公网IP信息\n$ ipinfo\n\n🔍 IP Information: 203.0.113.45\n┌─────────────────┬──────────────────────────────┐\n│ 字段            │ 值                           │\n├─────────────────┼──────────────────────────────┤\n│ 🌐 IP地址       │ 203.0.113.45                 │\n│ 🏙️ 城市         │ 旧金山                       │\n│ 📍 地区         │ 加利福尼亚                   │\n│ 🌍 国家         │ 美国                         │\n│ 🏢 组织         │ Example ISP Inc.             │\n│ ⏰ 时区         │ America/Los_Angeles          │\n└─────────────────┴──────────────────────────────┘\n```\n\n#### JSON输出（适合脚本使用）\n\n```bash\n$ ipinfo 1.1.1.1 -j\n\n{\n  \"ip\": \"1.1.1.1\",\n  \"hostname\": \"one.one.one.one\",\n  \"city\": \"Sydney\",\n  \"region\": \"New South Wales\",\n  \"country\": \"Australia\",\n  \"location\": \"-33.8688,151.2093\",\n  \"organization\": \"Cloudflare, Inc.\",\n  \"timezone\": \"Australia/Sydney\"\n}\n```\n\n#### 应用场景\n\n1. **网络调试** - 快速识别IP相关问题\n2. **安全分析** - 调查可疑IP地址\n3. **自动化脚本** - 在脚本中解析JSON输出\n4. **地理位置服务** - 为应用获取位置数据\n5. **DevOps** - 在流水线中监控和记录IP信息\n\n### 💡 设计理念\n\nIPInfo CLI 以简洁高效为设计理念：\n- **最小依赖** - 仅需必要的包\n- **跨平台** - 支持 Windows、macOS 和 Linux\n- **API容错** - 多API源确保可靠性\n- **整洁代码** - 文档完善、类型提示完整的Python代码\n\n### 📦 打包与部署\n\n```bash\n# 构建包\npip install build\npython -m build\n\n# 分发文件将生成在 dist/ 目录\n```\n\n### 🤝 贡献指南\n\n欢迎贡献代码！请随时提交Pull Request。\n\n1. Fork 本仓库\n2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交更改 (`git commit -m 'feat: 添加某个很棒的特性'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 打开 Pull Request\n\n### 📄 开源协议\n\n本项目采用 MIT 协议开源 - 详情请查看 [LICENSE](LICENSE) 文件。\n\n---\n\n## 🇹🇼 繁體中文\n\n### 🎉 專案介紹\n\n**IPInfo CLI** 是一款輕量級、現代化的命令列工具，用於查詢IP地址的詳細資訊。無論您是開發者、系統管理員還是安全專業人員，這款工具都能在終端機中快速準確地提供IP地理位置、ISP詳情和網路資訊。\n\n**核心亮點：**\n- 🚀 **快速輕量** - 毫秒級響應\n- 🎨 **美觀輸出** - 豐富多彩的終端顯示\n- 📊 **多種格式** - 支援表格、JSON或緊湊輸出\n- 🔒 **隱私優先** - 不收集資料，使用公共API\n- 🌐 **IPv4 \u0026 IPv6** - 完整支援兩種協定\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 🔍 **IP查詢** | 查詢任意公網IP地址的詳細資訊 |\n| 📍 **地理位置** | 取得城市、地區、國家和座標 |\n| 🏢 **組織資訊** | 查看ISP和組織詳情 |\n| ⏰ **時區資訊** | 顯示時區資料 |\n| 📋 **JSON匯出** | 匯出JSON格式資料用於腳本 |\n| 🎯 **本機IP** | 快速查看自己的公網IP |\n\n### 🚀 快速開始\n\n#### 環境要求\n- Python 3.8 或更高版本\n- pip（Python套件管理器）\n\n#### 安裝方式\n\n```bash\n# 從PyPI安裝（推薦）\npip install ipinfo-cli\n\n# 或從原始碼安裝\ngit clone https://github.com/gitstq/ipinfo-cli.git\ncd ipinfo-cli\npip install -e .\n```\n\n#### 使用方法\n\n```bash\n# 查看您的公網IP\nipinfo\n\n# 查詢特定IP地址\nipinfo 8.8.8.8\n\n# JSON格式輸出\nipinfo 8.8.8.8 --json\n\n# 緊湊格式輸出\nipinfo 8.8.8.8 --compact\n\n# 顯示版本\nipinfo --version\n```\n\n### 📖 詳細使用指南\n\n#### 基本命令\n\n```bash\n# 取得您的公網IP資訊\n$ ipinfo\n\n🔍 IP Information: 203.0.113.45\n┌─────────────────┬──────────────────────────────┐\n│ 欄位            │ 值                           │\n├─────────────────┼──────────────────────────────┤\n│ 🌐 IP地址       │ 203.0.113.45                 │\n│ 🏙️ 城市         │ 舊金山                       │\n│ 📍 地區         │ 加利福尼亞                   │\n│ 🌍 國家         │ 美國                         │\n│ 🏢 組織         │ Example ISP Inc.             │\n│ ⏰ 時區         │ America/Los_Angeles          │\n└─────────────────┴──────────────────────────────┘\n```\n\n#### JSON輸出（適合腳本使用）\n\n```bash\n$ ipinfo 1.1.1.1 -j\n\n{\n  \"ip\": \"1.1.1.1\",\n  \"hostname\": \"one.one.one.one\",\n  \"city\": \"Sydney\",\n  \"region\": \"New South Wales\",\n  \"country\": \"Australia\",\n  \"location\": \"-33.8688,151.2093\",\n  \"organization\": \"Cloudflare, Inc.\",\n  \"timezone\": \"Australia/Sydney\"\n}\n```\n\n#### 應用場景\n\n1. **網路除錯** - 快速識別IP相關問題\n2. **安全分析** - 調查可疑IP地址\n3. **自動化腳本** - 在腳本中解析JSON輸出\n4. **地理位置服務** - 為應用取得位置資料\n5. **DevOps** - 在管線中監控和記錄IP資訊\n\n### 💡 設計理念\n\nIPInfo CLI 以簡潔高效為設計理念：\n- **最小依賴** - 僅需必要的套件\n- **跨平台** - 支援 Windows、macOS 和 Linux\n- **API容錯** - 多API來源確保可靠性\n- **整潔程式碼** - 文件完善、型別提示完整的Python程式碼\n\n### 📦 打包與部署\n\n```bash\n# 建構套件\npip install build\npython -m build\n\n# 分發檔案將生成在 dist/ 目錄\n```\n\n### 🤝 貢獻指南\n\n歡迎貢獻程式碼！請隨時提交Pull Request。\n\n1. Fork 本儲存庫\n2. 建立特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交變更 (`git commit -m 'feat: 新增某個很棒的功能'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 開啟 Pull Request\n\n### 📄 開源授權\n\n本專案採用 MIT 授權條款開源 - 詳情請查看 [LICENSE](LICENSE) 檔案。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by [gitstq](https://github.com/gitstq)**\n\n**⭐ If this project helps you, please give it a star! ⭐**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fipinfo-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fipinfo-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fipinfo-cli/lists"}