# TelcoAIO — full LLM reference

> Browser-native toolbox for telecom and network engineering. Bilingual (English + Simplified Chinese). This file flattens every tool spec into text so that LLMs can ingest the full catalog without crawling each page.
>
> For JSON consumers, use https://telcoaio.com/tools.json instead.
> Last generated: 2026-04-20T05:22:08+00:00

## How to read this file

Each tool appears once, under its canonical English name. Fields are:
- **tool_key** — stable identifier shared by the EN and ZH pages.
- **urls** — live pages in each language.
- **category / tags** — taxonomic hints.
- **inputs / outputs / use_cases / limitations** — human-readable spec.
- **data_sources** — external APIs (if any). Tools without a `data_sources`
  line run purely in the browser.
- **example_input / example_output** — only present for priority-1 tools so far.

## Tools


### Category — Addressing & IP (地址与 IP)


---

#### IP Subnet Calculator / IP 子网计算器

- tool_key: `ipSubnetCalculator`
- urls:
  - EN: https://telcoaio.com/ipSubnetCalculator.html
  - ZH: https://telcoaio.com/ipSubnetCalculator_cn.html
- category: addressing
- tags: subnet, ipv4, ipv6, planning

**Summary (EN):** Compute IPv4 / IPv6 subnet details — network, broadcast, host range, and more.
**Summary (ZH):** 计算 IPv4 / IPv6 子网信息 —— 网络号、广播、主机范围等。


**Inputs (EN):**
- An IPv4 address and mask (CIDR or dotted-decimal)
- An IPv6 address and prefix length


**Outputs (EN):**
- Network ID / prefix
- Subnet mask / prefix length
- Broadcast address (IPv4)
- Usable host range
- Total host count
- Wildcard mask and address class (IPv4)


**Use cases (EN):**
- Planning a new subnet block
- Validating a customer-supplied range
- Quick lookup during incident response


**Limitations (EN):**
- Single subnet per calculation — use VLSM Calculator for splits
- Pure-browser math, no external lookups


**Example input:**
```
192.168.1.0/24
```

**Example output:**
```
Network:        192.168.1.0
Mask:           255.255.255.0  (/24)
Broadcast:      192.168.1.255
Host range:     192.168.1.1 – 192.168.1.254
Host count:     254
```


---

#### IP Format Converter / IP 格式转换器

- tool_key: `ipFormatConverter`
- urls:
  - EN: https://telcoaio.com/ipFormatConverter.html
  - ZH: https://telcoaio.com/ipFormatConverter_cn.html
- category: addressing
- tags: ipv4, ipv6, conversion

**Summary (EN):** Convert IP addresses between decimal, hex, binary, and integer forms.
**Summary (ZH):** 在十进制、十六进制、二进制和整数之间转换 IP 地址。



---

#### IP Aggregation / IP 聚合

- tool_key: `IPAggregation`
- urls:
  - EN: https://telcoaio.com/IPAggregation.html
  - ZH: https://telcoaio.com/IPAggregation_cn.html
- category: addressing
- tags: ipv4, ipv6, supernet

**Summary (EN):** Aggregate IPv4 / IPv6 prefixes into the smallest covering supernets.
**Summary (ZH):** 把 IPv4 / IPv6 前缀聚合成最小覆盖的超网。



---

#### VLSM Calculator / VLSM 子网计算器

- tool_key: `vlsmCalculator`
- urls:
  - EN: https://telcoaio.com/vlsmCalculator.html
  - ZH: https://telcoaio.com/vlsmCalculator_cn.html
- category: addressing
- tags: vlsm, subnet, planning

**Summary (EN):** Plan variable-length subnet masks from a parent block and host counts.
**Summary (ZH):** 按主机数从父网段规划变长子网。



---

#### Wildcard Calculator / 通配符掩码计算

- tool_key: `wildcardCalc`
- urls:
  - EN: https://telcoaio.com/wildcardCalc.html
  - ZH: https://telcoaio.com/wildcardCalc_cn.html
- category: addressing
- tags: wildcard, acl

**Summary (EN):** Compute wildcard masks for ACLs and route policies.
**Summary (ZH):** 为 ACL 与路由策略计算通配符掩码。



---

#### IPv6 Convert / IPv6 压缩/展开

- tool_key: `ipv6Convert`
- urls:
  - EN: https://telcoaio.com/ipv6Convert.html
  - ZH: https://telcoaio.com/ipv6Convert_cn.html
- category: addressing
- tags: ipv6, compression

**Summary (EN):** Compress and expand IPv6 addresses between canonical forms.
**Summary (ZH):** 在规范形式之间压缩与展开 IPv6 地址。



---

#### CIDR ↔ IP List / CIDR 与 IP 列表转换

- tool_key: `cidrExpand`
- urls:
  - EN: https://telcoaio.com/cidrExpand.html
  - ZH: https://telcoaio.com/cidrExpand_cn.html
- category: addressing
- tags: cidr, ip-list

**Summary (EN):** Convert between CIDR notation and explicit IP address lists.
**Summary (ZH):** 在 CIDR 表示与具体 IP 列表之间转换。



---

#### MAC Lookup / MAC 地址查询

- tool_key: `macLookup`
- urls:
  - EN: https://telcoaio.com/macLookup.html
  - ZH: https://telcoaio.com/macLookup_cn.html
- category: addressing
- tags: mac, oui, vendor

**Summary (EN):** Identify MAC address vendors via local OUI snapshots.
**Summary (ZH):** 通过本地 OUI 快照识别 MAC 地址厂商。



### Category — Lookup & Visibility (查询与可见性)


---

#### DNS Lookup / DNS 查询

- tool_key: `dnsLookUp`
- urls:
  - EN: https://telcoaio.com/dnsLookUp.html
  - ZH: https://telcoaio.com/dnsLookUp_cn.html
- category: lookup
- tags: dns, resolution, doh
- data_sources: Google Public DNS (DoH); Cloudflare DNS (DoH)
- freshness: live

**Summary (EN):** Query DNS records via Google Public DNS and Cloudflare DoH in one call.
**Summary (ZH):** 同时通过 Google Public DNS 与 Cloudflare DoH 查询 DNS 记录。


**Inputs (EN):**
- A domain name (e.g. google.com)
- Record type: A, AAAA, MX, CNAME, TXT, NS, SOA, SRV, PTR, CAA, ANY


**Outputs (EN):**
- Raw JSON response from Google DNS
- Raw JSON response from Cloudflare DNS
- Side-by-side comparison helpful for spotting resolver divergence


**Use cases (EN):**
- DNS troubleshooting across two independent resolvers
- Verifying propagation of new records
- Quick sanity check during migration


**Limitations (EN):**
- Uses public DoH endpoints; not your recursive resolver
- Single-domain per query


**Example input:**
```
google.com (type A)
```

**Example output:**
```
Google DNS:     Answer: 142.250.x.x
Cloudflare DNS: Answer: 142.250.x.x
(Full JSON shown in the UI for each resolver)
```


---

#### Batch PTR Lookup / 批量 PTR 查询

- tool_key: `batchPtr`
- urls:
  - EN: https://telcoaio.com/batchPtr.html
  - ZH: https://telcoaio.com/batchPtr_cn.html
- category: lookup
- tags: dns, ptr, reverse

**Summary (EN):** Bulk reverse-DNS resolution for IP ranges and lists.
**Summary (ZH):** 对 IP 区段或列表进行批量反向 DNS 解析。



---

#### IP Information Lookup / IP 信息查询

- tool_key: `IPInformation`
- urls:
  - EN: https://telcoaio.com/IPInformation.html
  - ZH: https://telcoaio.com/IPInformation_cn.html
- category: lookup
- tags: bgp, rpki, irr, geolocation, whois
- data_sources: RIPEstat Data API; RIPE Database REST API
- freshness: near-real-time

**Summary (EN):** One-stop prefix intel: BGP visibility, RPKI, IRR, WHOIS, geo, routing history.
**Summary (ZH):** 一站式前缀情报：BGP 可见性、RPKI、IRR、WHOIS、地理定位、路由历史。


**Inputs (EN):**
- One or more public prefixes, one per line, up to 50
- Prefer network-ID (e.g. 8.8.8.0/24) over host addresses for accuracy


**Outputs (EN):**
- BGP Announcements — visibility and announcement context
- Geolocation — country / coarse location hints for the prefix
- RPKI & IRR — ROA validation and route-object status
- WHOIS Registration — registry records
- Prefix Overview — consolidated summary
- Routing History — how the prefix has moved over time


**Use cases (EN):**
- RPKI-invalid prefix triage
- Confirming route-origin after a new announcement
- Sanity-checking geo data before escalations
- Looking up registry context without leaving the toolbox


**Limitations (EN):**
- Public prefixes only; no private / RFC1918 intelligence
- Large lists are slower because multiple data sources are queried
- Subject to upstream RIPE API rate limits and availability


**Example input:**
```
8.8.8.0/24
1.1.1.0/24
```

**Example output:**
```
BGP Announcements: visible upstream, origin ASNs listed
RPKI & IRR:        ROA valid for each prefix, IRR route-objects present
Geolocation:       US / AU
(Full structured results shown per button in the UI)
```


---

#### Looking Glass Directory / 运营商 Looking Glass

- tool_key: `majorLookingGlass`
- urls:
  - EN: https://telcoaio.com/majorLookingGlass.html
  - ZH: https://telcoaio.com/majorLookingGlass_cn.html
- category: lookup
- tags: looking-glass, isp

**Summary (EN):** Curated directory of major operator looking glasses.
**Summary (ZH):** 常见大型运营商 Looking Glass 的精选目录。



---

#### Port Lookup / 端口查询

- tool_key: `portLookup`
- urls:
  - EN: https://telcoaio.com/portLookup.html
  - ZH: https://telcoaio.com/portLookup_cn.html
- category: lookup
- tags: ports, iana

**Summary (EN):** Look up IANA port-to-service mappings and common usage.
**Summary (ZH):** 查询 IANA 端口与服务的对应关系及常见用途。



### Category — Routing & BGP (路由与 BGP)


---

#### ASN Converter & Ownership Lookup / ASN 转换器与归属查询

- tool_key: `ASNConvertor`
- urls:
  - EN: https://telcoaio.com/ASNConvertor.html
  - ZH: https://telcoaio.com/ASNConvertor_cn.html
- category: routing
- tags: asn, bgp, routing, ownership
- data_sources: RIPE Database REST API; RIPEstat Data API
- freshness: near-real-time

**Summary (EN):** Convert ASPlain / ASDot notation and identify ASN ownership.
**Summary (ZH):** 在 ASPlain 与 ASDot 之间转换 ASN，并查询归属信息。


**Inputs (EN):**
- A single ASN in ASPlain (e.g. 65537) or ASDot (e.g. 1.1) notation


**Outputs (EN):**
- Normalized ASN (ASPlain + ASDot)
- AS name
- Organisation
- One-hop neighbour summary


**Use cases (EN):**
- Quick ASN notation normalization
- Ownership verification during incident triage
- Basic BGP context lookup without opening a full looking glass


**Limitations (EN):**
- Only one ASN per query
- Depends on upstream RIPE data availability and freshness


**Example input:**
```
65537
```

**Example output:**
```
ASN (ASPlain): 65537
ASN (ASDot):   1.1
AS Name:       EXAMPLE-AS
Organisation:  Example Holdings
One-hop neighbours: (summary list)
```


---

#### ASN Details / ASN 信息查询

- tool_key: `ASNinformation`
- urls:
  - EN: https://telcoaio.com/ASNinformation.html
  - ZH: https://telcoaio.com/ASNinformation_cn.html
- category: routing
- tags: asn, bgp, routing

**Summary (EN):** Inspect BGP neighbours, announced prefixes, and activity for an ASN.
**Summary (ZH):** 查看某个 ASN 的邻居、宣告前缀与活动情况。



---

#### BGP Visualizer / BGP 路由可视化

- tool_key: `bgpVisualizer`
- urls:
  - EN: https://telcoaio.com/bgpVisualizer.html
  - ZH: https://telcoaio.com/bgpVisualizer_cn.html
- category: routing
- tags: bgp, routing, visualization

**Summary (EN):** Visualize AS-path relationships and BGP routing context.
**Summary (ZH):** 可视化 AS-path 关系与 BGP 路由上下文。



---

#### BGP Community Parser / BGP Community 解析

- tool_key: `bgpCommunity`
- urls:
  - EN: https://telcoaio.com/bgpCommunity.html
  - ZH: https://telcoaio.com/bgpCommunity_cn.html
- category: routing
- tags: bgp, community

**Summary (EN):** Parse standard, extended, and large BGP communities against known registries.
**Summary (ZH):** 解析标准、扩展与 Large BGP Community，并对照常见注册表。



---

#### AS-SET Expander / AS-SET 展开

- tool_key: `asSetExpand`
- urls:
  - EN: https://telcoaio.com/asSetExpand.html
  - ZH: https://telcoaio.com/asSetExpand_cn.html
- category: routing
- tags: as-set, irr, bgp

**Summary (EN):** Recursively expand AS-SET macros from IRR data sources.
**Summary (ZH):** 从 IRR 数据源递归展开 AS-SET 宏。



---

#### Route Filter Generator / 路由过滤器生成

- tool_key: `routeFilter`
- urls:
  - EN: https://telcoaio.com/routeFilter.html
  - ZH: https://telcoaio.com/routeFilter_cn.html
- category: routing
- tags: bgp, prefix-list, route-filter, policy

**Summary (EN):** Generate prefix-list / route-filter snippets for common network OSes.
**Summary (ZH):** 为常见网络操作系统生成 prefix-list / route-filter 片段。


**Inputs (EN):**
- List of IPv4 or IPv6 prefixes, one per line
- Inline qualifiers such as '10.0.0.0/8 le 24'
- Target vendor (Cisco IOS, IOS-XR, Junos, Bird, FRR)
- Action (permit / deny / accept / reject)
- List name (used as the policy identifier)


**Outputs (EN):**
- Vendor-specific prefix-list or route-filter snippet
- Ready to paste into running config


**Use cases (EN):**
- Turnkey prefix-list for a new customer or peer
- Rapid conversion between vendor dialects
- Converting ad-hoc prefix lists into reviewable policy


**Limitations (EN):**
- Runs fully in-browser; no config validation against a real device
- Does not resolve AS-SETs — pair with AS-SET Expander for that workflow


**Example input:**
```
10.0.0.0/8 le 24
192.0.2.0/24
```

**Example output:**
```
ip prefix-list FILTER-LIST seq 5 permit 10.0.0.0/8 le 24
ip prefix-list FILTER-LIST seq 10 permit 192.0.2.0/24
```


### Category — Config & Text (配置与文本)


---

#### Config Diff / 配置对比

- tool_key: `configDiff`
- urls:
  - EN: https://telcoaio.com/configDiff.html
  - ZH: https://telcoaio.com/configDiff_cn.html
- category: config
- tags: diff, config

**Summary (EN):** Compare two device configurations side by side.
**Summary (ZH):** 并排比较两份设备配置。



---

#### Config Highlighter / 配置语法高亮

- tool_key: `configHighlight`
- urls:
  - EN: https://telcoaio.com/configHighlight.html
  - ZH: https://telcoaio.com/configHighlight_cn.html
- category: config
- tags: highlight, config

**Summary (EN):** Vendor-aware syntax highlighting for common network configs.
**Summary (ZH):** 针对常见网络配置的厂商感知语法高亮。



---

#### Maintenance Generator / 维护通知生成

- tool_key: `notificationGenerator`
- urls:
  - EN: https://telcoaio.com/notificationGenerator.html
  - ZH: https://telcoaio.com/notificationGenerator_cn.html
- category: config
- tags: maintenance, notification, ics

**Summary (EN):** Draft bilingual maintenance notices and export ICS calendar invites.
**Summary (ZH):** 生成双语维护通知并导出 ICS 日历邀请。



### Category — Calculators (计算工具)


---

#### Bandwidth Calculator / 带宽计算器

- tool_key: `bandwidthCalc`
- urls:
  - EN: https://telcoaio.com/bandwidthCalc.html
  - ZH: https://telcoaio.com/bandwidthCalc_cn.html
- category: calculators
- tags: bandwidth, throughput

**Summary (EN):** Convert between bandwidth units and estimate transfer times.
**Summary (ZH):** 在不同带宽单位间转换并估算传输时间。



---

#### MTU Calculator / MTU 计算器

- tool_key: `mtuCalc`
- urls:
  - EN: https://telcoaio.com/mtuCalc.html
  - ZH: https://telcoaio.com/mtuCalc_cn.html
- category: calculators
- tags: mtu, mss

**Summary (EN):** Calculate effective MTU / MSS across overlays and tunnels.
**Summary (ZH):** 计算叠加网络与隧道的有效 MTU / MSS。



---

#### SLA Calculator / SLA 计算器

- tool_key: `slaCalc`
- urls:
  - EN: https://telcoaio.com/slaCalc.html
  - ZH: https://telcoaio.com/slaCalc_cn.html
- category: calculators
- tags: sla, availability

**Summary (EN):** Translate nines-of-availability into allowed downtime.
**Summary (ZH):** 把可用性 nines 转换为允许的停机时间。



### Category — Resources (资源)


---

#### Useful Links / 实用资源

- tool_key: `UsefulLinks`
- urls:
  - EN: https://telcoaio.com/UsefulLinks.html
  - ZH: https://telcoaio.com/UsefulLinks_cn.html
- category: resources
- tags: links, references

**Summary (EN):** Curated external references for day-to-day network work.
**Summary (ZH):** 日常网络工作中常用的外部参考资源精选。




## Appendix — site-level facts

- Authoring: static Jekyll site, no backend, no auth.
- Deployment: GitHub Pages.
- Bilingual routing: every English page `foo.html` has a Chinese twin `foo_cn.html`. Hreflang is declared in `<head>`.
- Sitemap: https://telcoaio.com/sitemap.xml
- robots.txt: https://telcoaio.com/robots.txt (explicitly allows GPTBot, ClaudeBot, PerplexityBot, Google-Extended, CCBot, Applebot-Extended, Bytespider, and others)
- Machine index: https://telcoaio.com/tools.json
- Source of truth for this file: `_data/tool_specs.yml` in the repository.