Skip to content

yuedanlabs/icp-query-extension

Repository files navigation

Browser Extension for ICP, DNS, Whois & GEO Queries

GitHub

English | 简体中文

Introduction

ICP Query Extension is an open-source browser extension that allows you to conveniently query details for the current website you're visiting, including:

  • ICP
  • DNS
  • Whois
  • GEO (geographic location and ISP)

Installation

  1. Chrome Web Store: Install directly from the Chrome Web Store (Recommended).
  2. Source Releases: Download the zip release package for manual installation.
  3. Build from source code (follow the instructions in the "Getting Started" section).

Graphic Demo

Display the ICP info of current tab's domain, with only just one click on the extension icon.


(Main Page)


(Main Page)


(Main Page with no API)


(Options Page)


(Options Page)

Getting Started

To build the extension from the source code:

  1. Clone this repository to your local machine.
    $ git clone https://github.com/yuedanlabs/icp-query-extension.git
  2. Build the extension.
    $ cd icp-query-extension
    $ pnpm install
    $ pnpm run build
    The dist files will be available in the build/chrome-mv3-prod directory.
  3. Install the extension in Chrome.
    • Open chrome://extensions/ in your Chrome browser.
    • Enable "Developer Mode" in the top right corner.
    • Click the "Load unpacked extension..." button.
    • Select the icp-query-extension/build/chrome-mv3-prod folder.
    • Click the "Load" button.
    • Pin the extension to the toolbar if desired.
    • Set the API URL in the "Options" page.
  4. Enjoy!

Sponsors

labring/laf

About the API

This extension is designed to work with any API that conforms to the following data structure:

  • API URL The API URL should include a query parameter url for the domain to be queried. Example: https://your-domain/release/icp?url=www.baidu.com

  • API Response Data The API should return a JSON response with the following structure:

    • API V2
    {
      "icp": {
        "subject": {
          "name": "北京百度网讯科技有限公司",
          "nature": "企业",
          "license": "京ICP证030173号",
          "updateTime": "2023-05-29 08:20:36"
        },
        "website": {
          "domain": "baidu.com",
          "license": "京ICP证030173号-1"
        }
      },
      "whois": {
        "Domain Status": [
          "clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited",
          "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
          "clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited",
          "serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited",
          "serverTransferProhibited https://icann.org/epp#serverTransferProhibited",
          "serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited"
        ],
        "Name Server": [
          "NS1.BAIDU.COM",
          "NS2.BAIDU.COM",
          "NS3.BAIDU.COM",
          "NS4.BAIDU.COM",
          "NS7.BAIDU.COM"
        ],
        "Created Date": "1999-10-11T11:05:17Z",
        "Updated Date": "2022-09-01T03:54:43Z",
        "Expiry Date": "2026-10-11T11:05:17Z",
        "Registrar": "MarkMonitor Inc."
      },
      "dns": {
        "A": [
          "180.101.50.242",
          "180.101.50.188"
        ],
        "AAAA": [],
        "CNAME": [
          "www.a.shifen.com"
        ],
        "NS": [],
        "GEO": {
          "isp": "电信",
          "area": "中国 江苏 南京"
        }
      }
    }
    • API V1
    [
      {
        "subject": {
          "name": "北京百度网讯科技有限公司",
          "nature": "企业",
          "license": "京ICP证030173号",
          "updateTime": "2023-01-10 09:43:35"
        },
        "website": {
          "domain": "baidu.com",
          "license": "京ICP证030173号-1"
        },
        "whois": {
          "Domain Status": [
            "clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited",
            "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
            "clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited",
            "serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited",
            "serverTransferProhibited https://icann.org/epp#serverTransferProhibited",
            "serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited"
          ],
          "Name Server": [
            "NS1.BAIDU.COM",
            "NS2.BAIDU.COM",
            "NS3.BAIDU.COM",
            "NS4.BAIDU.COM",
            "NS7.BAIDU.COM"
          ],
          "Created Date": "1999-10-11T11:05:17Z",
          "Updated Date": "2022-09-01T03:54:43Z",
          "Expiry Date": "2026-10-11T11:05:17Z",
          "Registrar": "MarkMonitor Inc."
        },
        "dns": {
          "A": ["110.242.68.66", "39.156.66.10"],
          "AAAA": [],
          "CNAME": [],
          "NS": [
            "ns3.baidu.com",
            "dns.baidu.com",
            "ns4.baidu.com",
            "ns7.baidu.com",
            "ns2.baidu.com"
          ],
          "GEO": {
            "isp": "中国移动",
            "area": "中国 北京市 北京市"
          }
        }
      }
    ]

TODO

  • whois
  • DNS
  • GongAn Record
  • GEO & ISP
  • ICP
  • Other domains under the same subject
  • Options API and custom API

License

License MIT