Product & API documentation

A research platform built for clear, responsible security work.

Qustylex brings public-data lookups, a focused web assessment workflow, and a curated directory of more than 2,480 security and OSINT resources into one workspace. This guide explains what runs in Qustylex, what links to external services, and how to use each responsibly.

Updated 2026-10 ~45 min read Responsible-use first

Qustylex is a web-based security and research workspace. Its live API performs selected lookups against public DNS, RDAP/WHOIS, certificate-transparency, IP-intelligence, and HTTP sources; its URL assessment checks selected public-facing web properties; and its directory organizes 2,481 curated resource entries across security and OSINT topics. Directory entries are links and descriptions: Qustylex does not install or execute those third-party tools for you.

The platform is beyond an early prototype in breadth: it combines a substantial reference catalog with working DNS, domain, IP, HTTP, email-security, and web-assessment routes. Each result depends on the external data source, network conditions, and the target's configuration. Treat findings as leads to verify, not as guarantees or a substitute for professional review.

Who this is for. Owners and administrators reviewing systems they control, and professionals acting under explicit written authorization and a defined scope. Do not use the platform to target other people's systems or personal information without permission. Laws and contracts vary; public availability alone does not make an action lawful. This documentation is not legal advice.

What you can do #

Quick start #

From zero to your first operational scan in under three minutes. No configuration, no CLI, no dependencies required.

Sign in with GitHub
GitHub is the identity provider implemented in the current source. Review the requested scopes on GitHub's consent screen; the current flow reads profile data and includes a public-repository scope.
Open the Console
Once signed in, you land on /console. The console groups the URL assessment, public-data lookups, resource directory, and saved local workspace views.
Start a scan
Open URL Scanner and enter only a domain you own or are explicitly authorized to assess. It runs selected HTTP and public-data checks; some checks make requests to the target, so use an approved scope and stop if the owner asks you to stop.
Review the report
Review each result in context. Automated checks can produce false positives or miss issues; independently verify findings and report them through the system owner's approved disclosure channel.
Data handling. Do not submit secrets or personal data unless you are authorized to do so. Requests are processed by Qustylex and may contact named third-party data providers; consult the service's current privacy notice for retention and provider details. Do not assume scan inputs or results are never logged.

Authentication #

Qustylex uses GitHub OAuth 2.0 as its only identity provider. This is a deliberate design decision. It removes password storage, eliminates email loops, and gives every account a verifiable identity backed by GitHub's security infrastructure.

Sign-in flow

Initiation
You click Continue with GitHub. The server generates a cryptographically random state value, sets it as an HttpOnly cookie, and redirects you to GitHub.
Authorization
You authorize the app on GitHub. GitHub redirects back with a temporary code, the original state, and an iss parameter identifying GitHub as the authorization server.
Verification
The server validates that the incoming state matches the cookie set at initiation, and that iss equals https://github.com/login/oauth. Any mismatch aborts the flow.
Token exchange
The server exchanges the code for a short-lived GitHub access token, uses it to fetch the profile, and does not store it in the session or return it to the browser.
Session creation
The required profile fields are signed with HMAC-SHA256 and placed in an HttpOnly, Secure, SameSite=Lax cookie. HMAC provides integrity, not encryption: the payload is base64-encoded, not encrypted. The server validates the signature and seven-day expiry on protected requests.

Scopes requested

ScopePurposeData accessed
read:userRead profile informationUsername, ID, name, avatar, bio, public repository count, followers, following, profile URL

The current source requests read:user only. It does not request repository access or email access. Review GitHub's consent screen before approving access.

Revoking access. If you revoke Qustylex from your GitHub authorized apps, all active sessions become invalid on next verification. You will be redirected to /login.

The Console #

The console at /console is the operations hub. Every module is reachable from the left sidebar, organized by purpose.

Navigation structure

GroupContainsPurpose
OverviewHome, Dashboard, Explore, SearchDaily use, discovery, and intelligence gathering
My WorkOverview, Pulse, Favorites, Marked, RecentYour personal activity and shortcuts
ScannerURL Scanner, SQLi Test, Endpoint FuzzerDeep target analysis and vulnerability testing
IntelligenceOSINT, Network, Breach Data, Dark WebOpen-source data and infrastructure research
DefensePrivacy Stack, Crypto, ForensicsOperational security and data protection
OffenseWeb Security, Exploitation, All ToolsOffensive tooling and red teaming utilities

URL Scanner #

The URL Scanner is a focused web-assessment workflow for a public URL that you own or have written permission to test. It combines selected checks through the Qustylex API and public data sources, then presents structured results. It is not a full penetration test, does not prove that a site is secure, and should not be run against third-party targets without authorization.

Features

CheckDescription
Security HeadersAudits HSTS, CSP, X-Frame-Options, and Referrer-Policy.
WAF DetectionFingerprints Cloudflare, Akamai, Sucuri, and Imperva.
Technology StackIdentifies CMS, frameworks, and server software.
Public web surfaceChecks a bounded set of common paths and response metadata. A response is evidence to review, not proof of exposure or exploitability.
Input handling signalsRuns a limited detection check for selected database error patterns. It is not a comprehensive injection test; only use it inside an explicitly authorized scope.
Client-visible stringsLooks for selected token-like patterns in fetched public content. A match may be a false positive; treat possible credentials as sensitive and notify the owner without attempting to use them.

API Call

The scanner is powered by the /api/tools endpoint. You can trigger the entire suite or specific checks programmatically.

request.sh
curl -X GET "https://qustylex.vercel.app/api/tools?type=domain-full&q=example.com" \
  -H "Accept: application/json"

OSINT Arsenal #

The directory currently contains 2,481 curated resource entries across OSINT, network research, privacy, defensive security, forensics, and related categories. Entries are independently maintained links and descriptions, not software bundled with Qustylex. Opening one takes you to its provider; installation, accounts, pricing, availability, and terms are controlled by that provider. Qustylex does not run these resources in a hosted execution environment.

Catalog quality. The count is the number of entries in the current directory, not a claim that every link is online, audited, endorsed, or safe for every purpose. Check the upstream project's status, license, privacy practices, and scope before use.

Categories

CategoryTools
UsernameSherlock, Maigret, WhatsMyName, Blackbird
EmailHolehe, GHunt, Epieos, Hunter.io
Breach DataHave I Been Pwned, DeHashed, IntelX
GeolocationGoogle Earth, Sentinel Hub, SunCalc, Mapillary
Dark WebAhmia, DarkSearch, Torch
Curated only. Every tool in the arsenal is verified. We do not list dead links, abandoned projects, or tools that require shady installations. If it's in Qustylex, it works.

Network Intel #

The Network Intel module provides real-time reconnaissance on IP addresses, domains, and infrastructure. It bypasses the need for manual command-line tools by aggregating results from multiple sources.

Available Modules

ToolDescription
IP GeolocationCity, ISP, ASN, timezone for any IPv4/IPv6.
Reverse DNSFind hostnames pointing back to an IP.
WHOIS (RDAP)Registration data for IPs and domains.
Certificate TransparencyAll hosts from crt.sh certificates.
Subdomain EnumerationEnumerate subdomains from public logs.

Security Tools #

Beyond scanning, Qustylex provides access to a comprehensive suite of security tools for authorized professionals.

Tool Categories

CategoryExamplesUse Case
ExploitationMetasploit, Sliver, HavocAdversary simulation and C2 frameworks.
ForensicsVolatility, Autopsy, BinwalkMemory analysis, disk carving, firmware extraction.
CryptographyGnuPG, OpenSSL, HashcatEncryption, hashing, and cryptanalysis.
PrivacyTor, Tails, Qubes OSAnonymity and operational security.

Architecture Overview #

The repository is a static web application with serverless authentication and tool routes. Live results depend on the configured hosting environment and external data providers.

System diagram

BROWSER Static pages | Console | Documentation | | | OAuth/session | JSON requests v v VERCEL HOSTING /api/tools Static assets DNS / RDAP / HTTP checks /api/auth Public third-party data sources | v GitHub OAuth

Design principles

PrincipleHow it's applied
Route-specific accessThe console is guarded by middleware; the current /api/tools handler does not verify a session.
Small server surfaceStatic pages are separate from the serverless authentication and tool API routes.
Public-data integrationsLive results depend on upstream DNS, RDAP, IP-intelligence, and web services; availability and accuracy can vary.
Explicit scopeUse active checks only on systems you own or are authorized to assess.

Threat model #

This is a list of risks relevant to the application, not a security certification or evidence that every listed mitigation is implemented. Validate the deployed service and its controls independently.

In scope

  • Credential theft via XSS or CSRF
  • Session hijacking via cookie theft
  • Unauthorized data access via IDOR or authz bugs
  • Injection attacks (SQL, command, template)
  • Rate limit bypass and resource exhaustion
  • OAuth flow attacks (CSRF, mix-up, code interception)

Out of scope

  • Physical attacks on users or devices
  • Legal compulsion of infrastructure providers
  • Compromise of GitHub itself
  • Endpoint compromise (malware on user device)

Data flow #

Understanding how data moves through Qustylex is essential for designing investigations that respect rate limits and preserve privacy.

Overview

User Action Browser sends request with signed cookie ↓ Edge verifies TLS, checks CSP, forwards to API ↓ Auth middleware validates HMAC, extracts user and scopes ↓ Authorization check: does user have permission? ├── ALLOW → Business logic (scan, fetch, analyze) │ ↓ │ Audit log entry (append-only) │ ↓ │ Response to user (JSON + headers) │ └── DENY → 403 Forbidden

API overview #

The Qustylex API is a JSON HTTP API served from the same domain. The Console page and /api/tools both require a valid, unexpired GitHub session. Authentication does not establish that a target is authorized or that a request is legally permitted.

Base URL

base
https://qustylex.vercel.app/api

Authentication

The Console and /api/tools require the same valid GitHub session cookie. Requests without a valid, unexpired session receive 401. The cookie is HttpOnly; same-origin browser requests send it automatically.

browser request
fetch('/api/auth/me', {
        credentials: 'same-origin',
        cache: 'no-store',
        headers: { Accept: 'application/json' }
      })

Auth endpoints #

GET /api/auth/me

Returns the authenticated user's profile. Used to verify session validity on the client.

request
GET /api/auth/me
Cookie: qstx_user=<signed>
StatusMeaning
200Valid session. Returns user object.
401No session or signature invalid.
500Server misconfigured or internal error.

Tool endpoints #

This endpoint routes a GET request to a supported lookup or assessment check. It currently accepts type and q query parameters without checking a session at the route handler. Several checks make outbound requests to the supplied public target or data providers. Use only assets in your written authorization scope; documentation and disclaimers do not replace server-side access controls.

GET /api/tools

ParameterTypeDescription
typestringThe route identifier (e.g., domain-full, dns-all, whois).
qstringThe target (domain, IP, URL).
recordstringOptional for routes such as dns-propagation; selects the DNS record type.

Example: DNS Lookup

request.sh
curl -X GET "https://qustylex.vercel.app/api/tools?type=dns-all&q=example.com"

Error codes #

Every error response has the same shape:

error.jsonJSON
{
  "ok": false,
  "error": "Target unreachable",
}
StatusErrorCause
400bad_requestMissing required type or q parameter
403forbiddenPrivate or local address blocked by the handler
404not_foundUnknown tool route
405method_not_allowedRequest method is not GET
500server_errorUpstream or tool handler failed

Sessions #

The current implementation uses a signed cookie with a seven-day maximum age. The cookie payload contains the profile fields needed by the Console; the short-lived GitHub access token is discarded after profile lookup. The payload is base64-encoded and HMAC-signed, not encrypted. The server checks both the signature and expiry on protected requests.

cookie
name:     qstx_user
value:    <base64(JSON payload)>.<hex(HMAC-SHA256)>
flags:    HttpOnly; Secure; SameSite=Lax
max-age:  604800

Flags explained

FlagWhy
HttpOnlyJavaScript cannot read the cookie value. This does not prevent malicious same-origin script from making requests as the signed-in user.
SecureCookie is only sent over HTTPS.
SameSite=LaxBlocks most CSRF vectors while allowing normal navigation.

Encryption #

In transit

Browser and provider transport protections depend on the deployed hosting and each upstream service. This repository does not prove a platform-wide TLS version, HSTS preload, or cipher-suite guarantee; verify the live deployment before making such claims.

At rest

Do not assume application-level encryption at rest from this repository. Storage, logs, backups, and retention are controlled by the deployment platform and upstream providers and must be documented from their actual configuration.

Signing

Session cookies and payloads are signed with HMAC-SHA256. The verifier rejects invalid signatures, malformed payloads, and sessions older than seven days.

Responsible use #

Qustylex is a tool. It aggregates public data. It does not hack, does not bypass authentication, does not access private information. Everything it touches is already on the open internet.

Principles

  • Authorization first. Assess only assets you own or have explicit written permission to test, and stay within the agreed scope and time window.
  • Use low impact. Avoid repeated or high-volume requests, stop on instability, and follow the target's published rules and rate limits.
  • Protect people and data. Do not use OSINT links or results to stalk, dox, harass, discriminate, or access accounts or data without permission.
  • Handle findings responsibly. Minimize collection, protect any sensitive output, and disclose issues privately to the system owner.

Frequently asked questions #

Search the documentation to find these prepared answers. The answers describe the current repository and should be checked against the live deployment, especially for privacy, legal, and security-sensitive decisions.

Which targets may I scan?

Only assets you own or assets explicitly covered by written authorization. Confirm the exact domains, IP ranges, checks, request limits, and time window before scanning. A bug-bounty program's rules define its own scope; do not assume every subdomain is included.

What does the URL Scanner do?

It runs selected DNS, HTTP, security-header, technology, WAF, and public-surface checks through the tool API and external data sources. The exact checks can vary by target and provider response. It is not a full penetration test or a security certification.

Are all scanner checks passive?

No. Some checks make HTTP requests to the target, including requests to selected common paths and limited input-handling checks. Treat scanning as active testing and use it only within explicit authorization.

Does Qustylex exploit vulnerabilities automatically?

The documented scanner is intended to report selected signals, not to provide a full exploitation workflow. A signal is not proof that a vulnerability is exploitable. Do not attempt to access data, accounts, or systems outside your authorization.

Can a scan affect the target?

Any request can create load or trigger monitoring. Keep checks limited, respect the owner's rate limits, coordinate timing, and stop if the service behaves unexpectedly or the owner requests it.

Can I treat a scanner result as confirmed?

No. Automated results can be incomplete, stale, or false positives. Verify findings safely and manually within scope; do not treat a missing finding as evidence that a system is secure.

How should I report a possible vulnerability?

Use the system owner's published security contact or disclosure policy. Share only the minimum evidence needed, avoid real credentials or personal data, and do not continue testing beyond your authorization.

How many tools are in the Qustylex directory?

The current console source contains 2,481 directory entries. These are links and descriptions for external resources, not 2,481 applications operated or executed by Qustylex.

Can I run all 2,481 tools inside Qustylex?

No. The directory helps you discover external projects and services. Each provider controls its own installation, account requirements, pricing, availability, privacy practices, and terms.

What does OSINT mean here?

OSINT means research using information made available through public sources. It does not authorize access to private accounts, circumventing controls, or collecting personal data for harassment or surveillance.

May I use OSINT links to investigate a person?

Do not use the platform or its directory to stalk, dox, harass, intimidate, or discriminate against anyone. Collection and use of personal information can be regulated even when a source is publicly reachable. Follow applicable law and a legitimate, authorized purpose.

What data sources do live lookups use?

Depending on the route, live checks query public DNS resolvers, RDAP, IP-intelligence services, certificate data, or the supplied public web host. Results inherit the limitations and privacy policies of those providers.

Does the tool API require a signed-in session?

The current /api/tools handler rejects requests without a valid GitHub session. You are still responsible for having explicit authorization to assess any target.

Does the repository prove API rate limits are enabled?

No. The current tool handler shown in this repository does not implement an application-level rate limiter. Any provider or hosting limits are separate and should not be described as Qustylex safeguards without deployment evidence.

What parameters does the tools API accept?

The current handler accepts a route name in type and a lookup value in q; some routes accept additional query options such as a DNS record or selector. See the route-specific implementation and verify parameters before integrating.

Which GitHub permissions does sign-in request?

The current source requests read:user only. It does not request repository or email access. Review GitHub's consent screen before authorizing.

Do you store my GitHub token?

The callback uses the short-lived token to retrieve your GitHub profile, then discards it. The token is not placed in the session cookie or returned to the browser.

How long does the session cookie last?

The cookie and server-side verifier enforce a seven-day maximum session age. Signing out expires the browser cookie; revoking the app grant is a separate control in GitHub settings.

How do I revoke Qustylex access to GitHub?

Revoke the application from your GitHub authorized applications settings. That is the provider-side control for invalidating the OAuth grant; signing out locally only clears browser-side cookies.

Can I delete my account?

The current console does not document a self-service account-deletion workflow. Contact the service operator through its published privacy channel for a request; no completion time or retention outcome is promised here.

Do you sell data?

This repository alone cannot verify the deployed service's data-sharing practices or commercial model. Review the operator's current privacy notice and terms before submitting personal or confidential information.

How long are lookup inputs and results retained?

The repository does not establish the retention period for hosting logs, upstream providers, or production backups. The operator should publish those details in a deployment-specific privacy notice.

Are lookup inputs sent to third parties?

Some routes query external DNS, RDAP, IP-intelligence, or certificate services, and web checks contact the supplied target. Do not submit confidential values unless you are authorized and have reviewed the relevant provider policies.

Why GitHub OAuth only?

GitHub is the identity provider implemented in the current source. This does not by itself establish the full security or privacy properties of the deployment; review the scopes shown during consent.

How do I report a security issue?

Use the service operator's currently published security contact. Avoid sending credentials or personal data, and do not test beyond permission and scope.

Glossary #

TermDefinition
OSINTOpen-Source Intelligence. Data collected from public sources.
WAFWeb Application Firewall. Protects against attacks like SQLi and XSS.
SQLiSQL Injection. A vulnerability where malicious SQL is executed.
CT LogCertificate Transparency Log. Public record of SSL certificates.
RDAPRegistration Data Access Protocol. Modern WHOIS replacement.

Changelog #

Repository capability snapshot — 2026-10

  • GitHub OAuth sign-in and HMAC-signed session cookie
  • URL assessment and selected DNS, RDAP, IP, HTTP, and email-security lookups
  • Console directory with 2,481 external security and OSINT resource entries
  • Searchable documentation and prepared FAQ answers
  • API access controls and production privacy settings require deployment-level review