
ipbulucu
io.github.codeonthetable/ipbulucu
IP, DNS, TCP port, partial DNSBL and IPv4 subnet tools using ipbulucu.org.
Documentation
IPBulucu
Website · Türkçe API rehberi · English API guide · OpenAPI
Turkish and English public IP lookup and network tools. The website is a Next.js static export; PHP endpoints are hosted separately under /api/. Distribution folders contain the Chrome extension, Node SDK and Python SDK. Source changes are not automatically deployed or published.
Result limits
IP geolocation is approximate and supplied by ipwho.is. Missing provider data is explicit (geoStatus=unavailable). VPN, CGNAT, connection speed, identity, risk and game latency are not measured by the IP endpoint. IP monitoring runs only in an open browser tab. Server alerts are unavailable.
Choose an integration
Ready-to-run MCP: IPBulucu MCP 1.0.0 connects IP, DNS, TCP, DNSBL and subnet tools to a local stdio MCP client. Download the desktop MCPB bundle with its dependencies included, or use the versioned website tarball and npx configuration. Both distributions are separate from the npm SDK. No API key; no automatic queries on startup. MCP-declared requests, QA and website traffic are counted separately.
No API key is required. Use the REST quickstart for explicit timeouts, HTTP status checks and examples that handle unavailable geolocation. Requests without an IP argument describe the calling machine's public egress address; a backend call does not discover an end user's address.
The Node.js SDK update is now available on npm; version 1.0.1 introduced the transport checks below. PyPI still publishes 1.0.0 as checked on 14 November 2026. The Python 1.0.1 archive is available in the GitHub release, with installation instructions in its SDK guide and SHA256SUMS for verification. The Chrome ZIP is a developer build, not a store-approved update.
| Client | Registry release | GitHub archive 1.0.1 |
|---|---|---|
| Node.js SDK | npm 1.0.1 and later: 10-second timeout and HTTP status checks | Same transport behavior |
| Python SDK | PyPI 1.0.0: 5-second timeout; no HTTP status check | 10-second timeout and HTTP status checks |
The current npm SDK rejects HTTP errors and sends a self-declared SDK client header. PyPI 1.0.0 still parses JSON on HTTP error responses and does not send that header. Check the returned success field and catch request/JSON errors. Use direct REST when you need access to response headers such as Retry-After; do not retry automatically. Package downloads and self-declared client headers do not establish human or AI usage.
Node.js 18+
npm install ipbulucu
Save as lookup.cjs, then run node lookup.cjs. This makes one request with a ten-second timeout and no automatic retry.
const { getIp } = require('ipbulucu');
async function main() {
try {
const info = await getIp();
if (info?.success !== true) throw new Error('Lookup failed');
console.log(info.geoStatus === 'available'
? 'Approximate location available'
: 'Location unavailable; keep fields unknown');
} catch {
console.error('Lookup failed; no automatic retry');
process.exitCode = 1;
}
}
main();
Python
python -m pip install ipbulucu==1.0.0
Save as lookup.py, then run python lookup.py. This makes one request with the published SDK's five-second timeout.
import ipbulucu
import requests
try:
info = ipbulucu.get_ip()
if not isinstance(info, dict) or info.get('success') is not True:
raise ValueError('Lookup failed')
print('Approximate location available' if info.get('geoStatus') == 'available'
else 'Location unavailable; keep fields unknown')
except (requests.RequestException, ValueError):
print('Lookup failed; no automatic retry')
raise SystemExit(1)
These examples print only a status summary. Keep lookup inputs and raw responses out of logs and analytics. See the linked SDK guides for WHOIS and authorized TCP port checks; see the REST guide for all supported endpoints.
Development and release
Run npm ci then npm run build. The out/ directory contains static pages. A PHP-capable host and rewrite configuration are required for APIs; next start cannot serve this static export. Keep credentials outside source control. Build finalization and source checks are in scripts/ and tests/. Hosting release tooling and analytics reports are kept outside the public source history.
Measurement and privacy
Google Analytics measures website visits and tool events. Optional PHP counters aggregate endpoint, declared client category, action and HTTP status class by UTC day. They do not identify unique humans or authenticate AI agents. They are disabled until a writable ipbulucu-metrics directory is provisioned beside the document root, or IPBULUCU_METRICS_DIR points to another private directory outside it. No raw IP, query or user-agent string is written by these counters. Hosting access logs and third-party processing must be assessed separately; there is no blanket zero-log guarantee.
Privacy information · MIT license
Network diagnostic endpoints require the private writable budget directory described above; without it they return HTTP 429. Current shared limits are 120 tool requests/minute, 20 port checks/minute, at most 16 TCP ports and six seconds per port batch, and 850 geolocation provider calls/day. Text IP discovery does not consume geolocation calls. DNS comparison uses two resolvers from one server, not worldwide propagation coverage.
https://github.com/codeonthetable/ipbulucu.org/releases/download/mcpb-v1.0.0/ipbulucu-mcp-1.0.0.mcpb# mcpb: https://github.com/codeonthetable/ipbulucu.org/releases/download/mcpb-v1.0.0/ipbulucu-mcp-1.0.0.mcpb