Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/yuedanlabs/icp-query-extension

Browser Extension for ICP、DNS、Whois & GEO Query
https://github.com/yuedanlabs/icp-query-extension

browser-extension chrome-extension

Last synced: 1 day ago
JSON representation

Browser Extension for ICP、DNS、Whois & GEO Query

Awesome Lists containing this project

README

        





Browser Extension for ICP, DNS, Whois & GEO Queries



GitHub

[English](README.md) | [简体中文](README.zh-Hans.md)

## 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](https://chrome.google.com/webstore/detail/icp-query-extension/plmfnmaihcmijdanpbondfejclejejfa): Install directly from the Chrome Web Store (Recommended).
2. [Source Releases](https://github.com/yuedanlabs/icp-query-extension/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.
```bash
$ git clone https://github.com/yuedanlabs/icp-query-extension.git
```
2. Build the extension.
```bash
$ 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
```json
{
"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
```json
[
{
"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

- [x] whois
- [x] DNS
- [ ] GongAn Record
- [x] GEO & ISP
- [x] ICP
- [ ] Other domains under the same subject
- [ ] Options API and custom API

## License

[License MIT](LICENSE)