roq

command module
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 21, 2025 License: BSD-3-Clause Imports: 21 Imported by: 0

README

roq



[!NOTE] Test the exposed API keys you got while hunting.


  • supports 76+ services (AWS, GitHub, Stripe, Slack, OpenAI, and many more)
  • validates keys instantly with proper authentication methods
  • extracts user/account details from valid keys
  • rotates random User-Agent for each request
  • clean and pipe friendly output with JSON support


Installation

go install github.com/1hehaq/roq@latest

setup autocompletion for service names
echo -e "complete -W '\$(roq -list | grep -oP \"(?<=• )[a-z]+\")' roq" >> ~/.bashrc && source ~/.bashrc
  • then try this
    roq -s <TAB>
    
    roq -s git<TAB>
    


Flags

  -s      : service type (required)
  -k      : api key to verify (required)
  -secret : secret key (required for aws, twilio, razorpay, trello)
  -json   : output in json format
  -list   : list all supported services
  -v      : verbose output
  -h      : show help message


Example Commands

# verify a github token
roq -s github -k ghp_xxxxxxxxxxxx

# verify aws credentials
roq -s aws -k AKIA... -secret YOUR_SECRET_KEY

# verify stripe key and get json output
roq -s stripe -k sk_live_xxxxxxxxxxxx -json

# verify slack token and extract user details
roq -s slack -k xoxb-xxxxxxxxxxxx

# list all supported services
roq -list

# pipe multiple keys for batch verification
cat keys.txt | while read key; do roq -s github -k $key -json; done | jq -r 'select(.valid==true)'


Adding Custom Services

roq supports custom service configurations via the services.yaml file. You can add your own API services by defining them in the configuration file.


Configuration Location:

  • Default: services.yaml in the current directory
  • Or specify with environment variable or custom path

Basic Service Structure:

services YAML reference
View YAML Code
services:
  github:
    name: GitHub
    method: GET                         # HTTP method (GET, POST, etc.)
    url: https://api.github.com/user    # API endpoint
    headers:
      Authorization: "token {{.Key}}"   # {{.Key}} is replaced with the API key
      User-Agent: "{{.UserAgent}}"      # user agent string
    success_status: 200                 # expected HTTP status for success
    response_type: json                 # response format (json, xml, etc.)
    response_fields:                    # fields to extract from response
      - login
      - name
    details_format: "user: {{.login}}"  # format for displaying details
    error_field: message                # field containing error message
    requires_secret: false              # whether additional secret is needed

More Options:

  • Basic Auth: Use auth_type: basic, auth_user, and auth_pass
  • Multiple Secrets: Set requires_secret: true and secret_name
  • Dynamic URLs: Use placeholders like {{.Domain}} or {{.Instance}}
  • Custom Success Field: Define success_field for boolean validation

See the services.yaml file for more examples of different authentication methods and configurations.



  • If you see errors or invalid results
    • verify your API key format
    • check your internet connection
    • some services require additional parameters (domain, instance, etc.)
    • use -v for verbose output


[!CAUTION] never use roq for any illegal activities. I'm not responsible for your deeds with it. Use responsibly and only on authorized targets.




kindly for hackers
GitHub X

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL