MCPcopy Index your code
hub / github.com/audibleblink/passdb-backend

github.com/audibleblink/passdb-backend @v0.5.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.5.3 ↗ · + Follow
44 symbols 105 edges 3 files 6 documented · 14%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

PassDB

Password-dump database API server. See accompanying blog post for more details.

See also accompanying frontend

API

GET /usernames/{username}
GET /domains/{domain}
GET /passwords/{password}
GET /emails/{email}
# response =>  [{"username": "abc", "domain": "example.com", "password": "p4ssw0rd"}, ...]


# Breach info in which the given email was found
GET /breaches/{email}
# response => [{
  "Title": ...,
  "Domain": ...,
  "Date": ...,
  "Count": ...,
  "Description": ...,
  "LogoPath": ...,
},...]

Seeding

Torrents:

# Collection #1
magnet:?xt=urn:btih:b39c603c7e18db8262067c5926e7d5ea5d20e12e&dn=Collection+1

# Collections #2 - #5
magnet:?xt=urn:btih:d136b1adde531f38311fbf43fb96fc26df1a34cd&dn=Collection+%232-%235+%26+Antipublic

Dump entries should be in the format:

username,domain,password

# where
test@example.com:p4$$w0rd

# becomes
test,example.com,p4$$w0rd

Feel free to do this manually, though I had great success using GCP Dataprep

Once in the proper format, you can create the table and import the csv using the GCP Console, the GCP CLI tool, or from the web portal

This will take a while. You may want to manully upload to GCP Storage and copy in the data from there because if the upload fails with the GCP CLI, you'll have to start all over, and burn through more of your bandwidth (and credits).

Usage

The following enivironment varilables are necessary

# Project Name
GOOGLE_CLOUD_PROJECT=

# Format: $project.$dataset.$tablename
GOOGLE_BIGQUERY_TABLE=

# Obtained from the GCP Auth Console
GOOGLE_APPLICATION_CREDENTIALS=./credentials.json

# Have I Been Pwned API key
HIBP_API_KEY=

Run:

source .env
go run main.go [port]

Core symbols most depended-on inside this repo

Header
called by 10
cache.go
JSONError
called by 8
main.go
getEnvDuration
called by 6
cache.go
resultWriter
called by 4
main.go
Write
called by 3
cache.go
recordsBy
called by 3
main.go
WriteHeader
called by 2
cache.go
parameterize
called by 2
main.go

Shape

Function 33
Struct 8
Method 3

Languages

Go100%

Modules by API surface

main.go23 symbols
cache.go18 symbols
hibp/hibp.go3 symbols

For agents

$ claude mcp add passdb-backend \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page