vulpfest 1.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- vulpfest-1.0.0/.github/FUNDING.yml +5 -0
- vulpfest-1.0.0/.gitignore +8 -0
- vulpfest-1.0.0/LICENSE +21 -0
- vulpfest-1.0.0/PKG-INFO +103 -0
- vulpfest-1.0.0/README.md +72 -0
- vulpfest-1.0.0/SECURITY.md +5 -0
- vulpfest-1.0.0/pyproject.toml +32 -0
- vulpfest-1.0.0/src/vulpfest/__init__.py +1 -0
- vulpfest-1.0.0/src/vulpfest/__main__.py +108 -0
- vulpfest-1.0.0/src/vulpfest/banner.py +69 -0
- vulpfest-1.0.0/src/vulpfest/logo.py +19 -0
- vulpfest-1.0.0/src/vulpfest/tools/gmapscout/cli.py +51 -0
- vulpfest-1.0.0/src/vulpfest/tools/gmapscout/gmapscout_core.py +202 -0
- vulpfest-1.0.0/src/vulpfest/tools/leadscout/cli.py +52 -0
- vulpfest-1.0.0/src/vulpfest/tools/leadscout/leadscout_core.py +72 -0
- vulpfest-1.0.0/src/vulpfest/tools/scamcheck/checker.py +266 -0
- vulpfest-1.0.0/src/vulpfest/tools/scamcheck/cli.py +88 -0
- vulpfest-1.0.0/src/vulpfest/tools/scamcheck/ssrf_guard.py +142 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/auth_scan.py +175 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/cli.py +167 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/deep_web.py +353 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/dns_email.py +202 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/manual_review.py +60 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/repo_scan.py +434 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/scanner.py +886 -0
- vulpfest-1.0.0/src/vulpfest/tools/scanner/ssrf_guard.py +142 -0
- vulpfest-1.0.0/src/vulpfest/ui.py +38 -0
- vulpfest-1.0.0/tests/test_cli.py +27 -0
- vulpfest-1.0.0/tools/make_logo.py +90 -0
- vulpfest-1.0.0/tools/sync_tools.py +21 -0
vulpfest-1.0.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Febri Osht (Vulpfest)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
vulpfest-1.0.0/PKG-INFO
ADDED
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: vulpfest
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Vulpfest Lab tools in one place: a web security scanner and a scam-link checker, from your terminal.
|
|
5
|
+
Project-URL: Homepage, https://lab.vulpfest.com
|
|
6
|
+
Project-URL: Source, https://github.com/vulpfest/vulpfest-cli
|
|
7
|
+
Author: Febri Osht (Vulpfest)
|
|
8
|
+
License: MIT
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Keywords: anti-scam,osint,phishing,scanner,security,vulpfest
|
|
11
|
+
Requires-Python: >=3.9
|
|
12
|
+
Requires-Dist: beautifulsoup4>=4.12
|
|
13
|
+
Requires-Dist: requests>=2.32
|
|
14
|
+
Provides-Extra: all
|
|
15
|
+
Requires-Dist: ddgs>=6.0; extra == 'all'
|
|
16
|
+
Requires-Dist: openpyxl>=3.0; extra == 'all'
|
|
17
|
+
Requires-Dist: pandas>=2.0; extra == 'all'
|
|
18
|
+
Requires-Dist: selenium>=4.0; extra == 'all'
|
|
19
|
+
Requires-Dist: webdriver-manager>=4.0; extra == 'all'
|
|
20
|
+
Requires-Dist: xlsxwriter>=3.0; extra == 'all'
|
|
21
|
+
Provides-Extra: gmaps
|
|
22
|
+
Requires-Dist: openpyxl>=3.0; extra == 'gmaps'
|
|
23
|
+
Requires-Dist: pandas>=2.0; extra == 'gmaps'
|
|
24
|
+
Requires-Dist: selenium>=4.0; extra == 'gmaps'
|
|
25
|
+
Requires-Dist: webdriver-manager>=4.0; extra == 'gmaps'
|
|
26
|
+
Requires-Dist: xlsxwriter>=3.0; extra == 'gmaps'
|
|
27
|
+
Provides-Extra: leads
|
|
28
|
+
Requires-Dist: ddgs>=6.0; extra == 'leads'
|
|
29
|
+
Requires-Dist: pandas>=2.0; extra == 'leads'
|
|
30
|
+
Description-Content-Type: text/markdown
|
|
31
|
+
|
|
32
|
+
<p align="center">
|
|
33
|
+
<picture>
|
|
34
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/npm/@vulpfest/icons@0.3/svg/vulpfest-logo-night.svg">
|
|
35
|
+
<img src="https://cdn.jsdelivr.net/npm/@vulpfest/icons@0.3/svg/vulpfest-logo-day.svg" alt="Vulpfest" width="150">
|
|
36
|
+
</picture>
|
|
37
|
+
</p>
|
|
38
|
+
|
|
39
|
+
# vulpfest
|
|
40
|
+
|
|
41
|
+
All four free tools from [Vulpfest Lab](https://lab.vulpfest.com) in one terminal command. Type `vulpfest`,
|
|
42
|
+
pick a tool from the menu, and run it — on Windows, macOS or Linux.
|
|
43
|
+
|
|
44
|
+
| # | Tool | Command | What it does |
|
|
45
|
+
|---|---|---|---|
|
|
46
|
+
| 1 | Cyber Web Scanner | `vulpfest scan` | Checks your own website: headers, SSL/TLS, exposed files, JavaScript secrets, DNS and email, and (with `--repo`) your project folder |
|
|
47
|
+
| 2 | Scam Check | `vulpfest check` | Checks a suspicious link before you click it: fake app downloads, look-alike sites, hidden redirects, phishing forms |
|
|
48
|
+
| 3 | LeadScout | `vulpfest leads` | Researches B2B prospects from public search results |
|
|
49
|
+
| 4 | GMaps Scout | `vulpfest gmaps` | Turns publicly listed business details into a spreadsheet |
|
|
50
|
+
|
|
51
|
+
## Install
|
|
52
|
+
|
|
53
|
+
Requires Python 3.9 or newer.
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
pip install vulpfest # Cyber Web Scanner + Scam Check (light)
|
|
57
|
+
pip install "vulpfest[all]" # adds LeadScout and GMaps Scout
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Until the package is on PyPI, install it straight from GitHub:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
pip install "vulpfest[all] @ git+https://github.com/vulpfest/vulpfest-cli"
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
GMaps Scout drives a real browser, so it also needs **Google Chrome** installed.
|
|
67
|
+
|
|
68
|
+
## Use
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
vulpfest # menu: pick a tool by number
|
|
72
|
+
vulpfest scan example.com # scan your own website
|
|
73
|
+
vulpfest scan example.com --repo . # site + project folder in one report
|
|
74
|
+
vulpfest check bca-co-id.xyz # check a suspicious link
|
|
75
|
+
vulpfest leads --roles "software house" --industries "technology" --out leads.csv
|
|
76
|
+
vulpfest gmaps "coffee shop in Bali" --limit 20 --out places.xlsx
|
|
77
|
+
vulpfest <tool> --help # all options of a tool
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Each tool behaves exactly like its standalone version; the source of each one lives in its own repository:
|
|
81
|
+
[Cyber-Web-Scanner](https://github.com/FebriOsht/Cyber-Web-Scanner) ·
|
|
82
|
+
[linkcheck](https://github.com/FebriOsht/linkcheck) ·
|
|
83
|
+
[leadscout](https://github.com/FebriOsht/leadscout) ·
|
|
84
|
+
[gmap-scout](https://github.com/FebriOsht/gmap-scout).
|
|
85
|
+
|
|
86
|
+
## Responsible use
|
|
87
|
+
|
|
88
|
+
Scan only websites you own or are authorized to test. Collect only public data, respect each site''s terms,
|
|
89
|
+
and follow the data-protection law that applies to you.
|
|
90
|
+
|
|
91
|
+
## Security
|
|
92
|
+
|
|
93
|
+
Found a security issue? Please report it privately — see [SECURITY.md](SECURITY.md).
|
|
94
|
+
|
|
95
|
+
## Support this project
|
|
96
|
+
|
|
97
|
+
If these free tools help you, you can support their development at
|
|
98
|
+
[github.com/FebriOsht#support](https://github.com/FebriOsht#support) (Saweria, PayPal, or crypto).
|
|
99
|
+
Only send on the network stated there.
|
|
100
|
+
|
|
101
|
+
## License
|
|
102
|
+
|
|
103
|
+
MIT © 2026 Febri Osht (Vulpfest). See [LICENSE](LICENSE).
|
vulpfest-1.0.0/README.md
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/npm/@vulpfest/icons@0.3/svg/vulpfest-logo-night.svg">
|
|
4
|
+
<img src="https://cdn.jsdelivr.net/npm/@vulpfest/icons@0.3/svg/vulpfest-logo-day.svg" alt="Vulpfest" width="150">
|
|
5
|
+
</picture>
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
# vulpfest
|
|
9
|
+
|
|
10
|
+
All four free tools from [Vulpfest Lab](https://lab.vulpfest.com) in one terminal command. Type `vulpfest`,
|
|
11
|
+
pick a tool from the menu, and run it — on Windows, macOS or Linux.
|
|
12
|
+
|
|
13
|
+
| # | Tool | Command | What it does |
|
|
14
|
+
|---|---|---|---|
|
|
15
|
+
| 1 | Cyber Web Scanner | `vulpfest scan` | Checks your own website: headers, SSL/TLS, exposed files, JavaScript secrets, DNS and email, and (with `--repo`) your project folder |
|
|
16
|
+
| 2 | Scam Check | `vulpfest check` | Checks a suspicious link before you click it: fake app downloads, look-alike sites, hidden redirects, phishing forms |
|
|
17
|
+
| 3 | LeadScout | `vulpfest leads` | Researches B2B prospects from public search results |
|
|
18
|
+
| 4 | GMaps Scout | `vulpfest gmaps` | Turns publicly listed business details into a spreadsheet |
|
|
19
|
+
|
|
20
|
+
## Install
|
|
21
|
+
|
|
22
|
+
Requires Python 3.9 or newer.
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
pip install vulpfest # Cyber Web Scanner + Scam Check (light)
|
|
26
|
+
pip install "vulpfest[all]" # adds LeadScout and GMaps Scout
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Until the package is on PyPI, install it straight from GitHub:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
pip install "vulpfest[all] @ git+https://github.com/vulpfest/vulpfest-cli"
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
GMaps Scout drives a real browser, so it also needs **Google Chrome** installed.
|
|
36
|
+
|
|
37
|
+
## Use
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
vulpfest # menu: pick a tool by number
|
|
41
|
+
vulpfest scan example.com # scan your own website
|
|
42
|
+
vulpfest scan example.com --repo . # site + project folder in one report
|
|
43
|
+
vulpfest check bca-co-id.xyz # check a suspicious link
|
|
44
|
+
vulpfest leads --roles "software house" --industries "technology" --out leads.csv
|
|
45
|
+
vulpfest gmaps "coffee shop in Bali" --limit 20 --out places.xlsx
|
|
46
|
+
vulpfest <tool> --help # all options of a tool
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Each tool behaves exactly like its standalone version; the source of each one lives in its own repository:
|
|
50
|
+
[Cyber-Web-Scanner](https://github.com/FebriOsht/Cyber-Web-Scanner) ·
|
|
51
|
+
[linkcheck](https://github.com/FebriOsht/linkcheck) ·
|
|
52
|
+
[leadscout](https://github.com/FebriOsht/leadscout) ·
|
|
53
|
+
[gmap-scout](https://github.com/FebriOsht/gmap-scout).
|
|
54
|
+
|
|
55
|
+
## Responsible use
|
|
56
|
+
|
|
57
|
+
Scan only websites you own or are authorized to test. Collect only public data, respect each site''s terms,
|
|
58
|
+
and follow the data-protection law that applies to you.
|
|
59
|
+
|
|
60
|
+
## Security
|
|
61
|
+
|
|
62
|
+
Found a security issue? Please report it privately — see [SECURITY.md](SECURITY.md).
|
|
63
|
+
|
|
64
|
+
## Support this project
|
|
65
|
+
|
|
66
|
+
If these free tools help you, you can support their development at
|
|
67
|
+
[github.com/FebriOsht#support](https://github.com/FebriOsht#support) (Saweria, PayPal, or crypto).
|
|
68
|
+
Only send on the network stated there.
|
|
69
|
+
|
|
70
|
+
## License
|
|
71
|
+
|
|
72
|
+
MIT © 2026 Febri Osht (Vulpfest). See [LICENSE](LICENSE).
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
# Security policy
|
|
2
|
+
|
|
3
|
+
If you find a security issue in Cyber Web Scanner, please report it privately by email to **hello@vulpfest.com** instead of opening a public issue.
|
|
4
|
+
|
|
5
|
+
Please include the steps to reproduce the issue and the impact you expect. We will reply as soon as we can and keep you updated until it is fixed.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["hatchling"]
|
|
3
|
+
build-backend = "hatchling.build"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "vulpfest"
|
|
7
|
+
version = "1.0.0"
|
|
8
|
+
description = "Vulpfest Lab tools in one place: a web security scanner and a scam-link checker, from your terminal."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.9"
|
|
11
|
+
license = { text = "MIT" }
|
|
12
|
+
authors = [{ name = "Febri Osht (Vulpfest)" }]
|
|
13
|
+
keywords = ["security", "scanner", "anti-scam", "phishing", "vulpfest", "osint"]
|
|
14
|
+
dependencies = [
|
|
15
|
+
"requests>=2.32",
|
|
16
|
+
"beautifulsoup4>=4.12",
|
|
17
|
+
]
|
|
18
|
+
|
|
19
|
+
[project.optional-dependencies]
|
|
20
|
+
leads = ["ddgs>=6.0", "pandas>=2.0"]
|
|
21
|
+
gmaps = ["selenium>=4.0", "webdriver-manager>=4.0", "pandas>=2.0", "xlsxwriter>=3.0", "openpyxl>=3.0"]
|
|
22
|
+
all = ["ddgs>=6.0", "pandas>=2.0", "selenium>=4.0", "webdriver-manager>=4.0", "xlsxwriter>=3.0", "openpyxl>=3.0"]
|
|
23
|
+
|
|
24
|
+
[project.urls]
|
|
25
|
+
Homepage = "https://lab.vulpfest.com"
|
|
26
|
+
Source = "https://github.com/vulpfest/vulpfest-cli"
|
|
27
|
+
|
|
28
|
+
[project.scripts]
|
|
29
|
+
vulpfest = "vulpfest.__main__:main"
|
|
30
|
+
|
|
31
|
+
[tool.hatch.build.targets.wheel]
|
|
32
|
+
packages = ["src/vulpfest"]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
__version__ = "1.0.0"
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
"""Perintah `vulpfest`: menu interaktif + menjalankan keempat tools Vulpfest Lab.
|
|
2
|
+
|
|
3
|
+
vulpfest menu: pilih tool dengan nomor
|
|
4
|
+
vulpfest scan example.com Cyber Web Scanner
|
|
5
|
+
vulpfest check suspicious.link Scam Check
|
|
6
|
+
vulpfest leads --roles ... --industries ... LeadScout
|
|
7
|
+
vulpfest gmaps "coffee shop jakarta" GMaps Scout
|
|
8
|
+
"""
|
|
9
|
+
import importlib.util
|
|
10
|
+
import sys
|
|
11
|
+
from pathlib import Path
|
|
12
|
+
|
|
13
|
+
from . import __version__
|
|
14
|
+
from .banner import render
|
|
15
|
+
|
|
16
|
+
TOOLS_DIR = Path(__file__).resolve().parent / "tools"
|
|
17
|
+
TOOLS = {"scan": "scanner", "check": "scamcheck", "leads": "leadscout", "gmaps": "gmapscout"}
|
|
18
|
+
ORDER = ["scan", "check", "leads", "gmaps"]
|
|
19
|
+
NEEDS = {
|
|
20
|
+
"leads": [("ddgs", "duckduckgo_search"), ("pandas",)],
|
|
21
|
+
"gmaps": [("selenium",), ("webdriver_manager",), ("pandas",)],
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
def _has(names):
|
|
26
|
+
return any(importlib.util.find_spec(n) is not None for n in names)
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def available():
|
|
30
|
+
return {k for k, groups in NEEDS.items() if all(_has(g) for g in groups)}
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
def _utf8():
|
|
34
|
+
for stream in (sys.stdout, sys.stderr):
|
|
35
|
+
try:
|
|
36
|
+
stream.reconfigure(encoding="utf-8", errors="replace")
|
|
37
|
+
except Exception:
|
|
38
|
+
pass
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
def run_tool(key, args):
|
|
42
|
+
if key in NEEDS and key not in available():
|
|
43
|
+
print(f'{key} needs extra packages: pip install "vulpfest[{key}]"', file=sys.stderr)
|
|
44
|
+
if key == "gmaps":
|
|
45
|
+
print("GMaps Scout also needs Google Chrome installed.", file=sys.stderr)
|
|
46
|
+
return 2
|
|
47
|
+
tool_dir = TOOLS_DIR / TOOLS[key]
|
|
48
|
+
sys.path.insert(0, str(tool_dir))
|
|
49
|
+
sys.argv = [f"vulpfest {key}"] + list(args)
|
|
50
|
+
spec = importlib.util.spec_from_file_location(f"vulpfest_{TOOLS[key]}_cli", tool_dir / "cli.py")
|
|
51
|
+
module = importlib.util.module_from_spec(spec)
|
|
52
|
+
try:
|
|
53
|
+
spec.loader.exec_module(module)
|
|
54
|
+
rc = module.main()
|
|
55
|
+
except SystemExit as e:
|
|
56
|
+
if e.code is None:
|
|
57
|
+
return 0
|
|
58
|
+
return e.code if isinstance(e.code, int) else 1
|
|
59
|
+
return rc if isinstance(rc, int) else 0
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def interactive():
|
|
63
|
+
print(render(available()))
|
|
64
|
+
try:
|
|
65
|
+
choice = input("\nPilih tool (1-4), Enter untuk keluar: ").strip().lower()
|
|
66
|
+
if not choice:
|
|
67
|
+
return 0
|
|
68
|
+
key = ORDER[int(choice) - 1] if choice.isdigit() and 1 <= int(choice) <= 4 else choice
|
|
69
|
+
if key not in TOOLS:
|
|
70
|
+
print("Pilihan tidak dikenal.")
|
|
71
|
+
return 2
|
|
72
|
+
if key == "scan":
|
|
73
|
+
args = [input("Website (mis. example.com): ").strip()]
|
|
74
|
+
elif key == "check":
|
|
75
|
+
args = [input("Tautan yang ingin diperiksa: ").strip()]
|
|
76
|
+
elif key == "leads":
|
|
77
|
+
args = ["--roles", input("Roles, pisahkan dengan koma: ").strip(),
|
|
78
|
+
"--industries", input("Industries, pisahkan dengan koma: ").strip()]
|
|
79
|
+
else:
|
|
80
|
+
args = [input("Kata kunci pencarian (mis. coffee shop jakarta): ").strip()]
|
|
81
|
+
except (EOFError, KeyboardInterrupt):
|
|
82
|
+
print()
|
|
83
|
+
return 0
|
|
84
|
+
print()
|
|
85
|
+
return run_tool(key, args)
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
def main(argv=None):
|
|
89
|
+
_utf8()
|
|
90
|
+
argv = list(sys.argv[1:] if argv is None else argv)
|
|
91
|
+
if not argv:
|
|
92
|
+
return interactive() if sys.stdin.isatty() else (print(render(available())) or 0)
|
|
93
|
+
head = argv[0].lower()
|
|
94
|
+
if head in ("-h", "--help", "help", "menu"):
|
|
95
|
+
print(render(available()))
|
|
96
|
+
return 0
|
|
97
|
+
if head in ("-v", "--version", "version"):
|
|
98
|
+
print(f"vulpfest {__version__}")
|
|
99
|
+
return 0
|
|
100
|
+
if head not in TOOLS:
|
|
101
|
+
print(f"Tool tidak dikenal: {argv[0]}\n")
|
|
102
|
+
print(render(available()))
|
|
103
|
+
return 2
|
|
104
|
+
return run_tool(head, argv[1:])
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
if __name__ == "__main__":
|
|
108
|
+
sys.exit(main())
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
"""Logo rubah Vulpfest (ASCII) dan menu, gaya neofetch: logo di kiri, info di kanan."""
|
|
2
|
+
from . import __version__
|
|
3
|
+
from .ui import c
|
|
4
|
+
|
|
5
|
+
# Logo Vulpfest: dibuat dari path SVG asli (telinga Sigma, V, percikan) oleh tools/make_logo.py.
|
|
6
|
+
from .logo import LOGO
|
|
7
|
+
from .ui import rgb
|
|
8
|
+
|
|
9
|
+
SAND, ROSE = (243, 222, 186), (232, 165, 152) # gradasi warna logo
|
|
10
|
+
_W = len(LOGO[0])
|
|
11
|
+
FOX = [l.ljust(_W) for l in LOGO + ["", "V U L P F E S T".center(_W)]]
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def gradient(line):
|
|
15
|
+
n = max(len(line) - 1, 1)
|
|
16
|
+
out = []
|
|
17
|
+
for i, ch in enumerate(line):
|
|
18
|
+
if ch == " ":
|
|
19
|
+
out.append(ch)
|
|
20
|
+
continue
|
|
21
|
+
k = i / n
|
|
22
|
+
out.append(rgb(ch, *(round(SAND[j] + (ROSE[j] - SAND[j]) * k) for j in range(3))))
|
|
23
|
+
return "".join(out)
|
|
24
|
+
|
|
25
|
+
TOOLS = [
|
|
26
|
+
("scan", "Cyber Web Scanner", "Periksa keamanan situs Anda (header, SSL, file bocor, DNS).", "ready"),
|
|
27
|
+
("check", "Scam Check", "Periksa tautan mencurigakan sebelum diklik.", "ready"),
|
|
28
|
+
("leads", "LeadScout", "Riset prospek B2B dari hasil pencarian publik.", "leads"),
|
|
29
|
+
("gmaps", "GMaps Scout", "Kumpulkan detail bisnis publik ke spreadsheet.", "gmaps"),
|
|
30
|
+
]
|
|
31
|
+
|
|
32
|
+
STATUS = {
|
|
33
|
+
"ready": c("siap", "green"),
|
|
34
|
+
"leads": c("perlu: pip install vulpfest[leads]", "yellow"),
|
|
35
|
+
"gmaps": c("perlu: pip install vulpfest[gmaps] + Chrome", "yellow"),
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def render(available):
|
|
40
|
+
"""available: set berisi kunci tool yang dependensinya sudah terpasang."""
|
|
41
|
+
info = []
|
|
42
|
+
info.append(c("Vulpfest Lab", "fox", "bold") + c(f" v{__version__}", "gray"))
|
|
43
|
+
info.append(c("─" * 34, "gray"))
|
|
44
|
+
info.append(c("Alat gratis untuk keamanan & anti-penipuan.", "white"))
|
|
45
|
+
info.append("")
|
|
46
|
+
info.append(c("Tools:", "bold"))
|
|
47
|
+
for n, (key, name, desc, need) in enumerate(TOOLS, 1):
|
|
48
|
+
ok = need == "ready" or key in available
|
|
49
|
+
dot = c("●", "green") if ok else c("○", "yellow")
|
|
50
|
+
line = f" {dot} {c(str(n) + '.', 'bold')} {c(name, 'bold', 'white')} " + c(f"(vulpfest {key})", "cyan")
|
|
51
|
+
info.append(line)
|
|
52
|
+
info.append(" " + c(desc, "gray"))
|
|
53
|
+
if not ok:
|
|
54
|
+
info.append(" " + STATUS[need])
|
|
55
|
+
info.append("")
|
|
56
|
+
info.append(c("Contoh:", "bold") + c(" vulpfest scan example.com", "cyan"))
|
|
57
|
+
info.append(c(" vulpfest check bca-co-id.xyz", "cyan"))
|
|
58
|
+
info.append(c("Bantuan:", "bold") + c(" vulpfest <tool> --help", "cyan"))
|
|
59
|
+
|
|
60
|
+
fox = [gradient(line) for line in FOX]
|
|
61
|
+
# Sejajarkan logo (kiri) dan info (kanan)
|
|
62
|
+
pad = len(FOX)
|
|
63
|
+
rows = max(len(fox), len(info))
|
|
64
|
+
out = []
|
|
65
|
+
for i in range(rows):
|
|
66
|
+
left = fox[i] if i < len(fox) else " " * len(FOX[0])
|
|
67
|
+
right = info[i] if i < len(info) else ""
|
|
68
|
+
out.append(f"{left} {right}")
|
|
69
|
+
return "\n".join(out)
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
"""Dibuat otomatis oleh tools/make_logo.py dari path SVG logo Vulpfest."""
|
|
2
|
+
LOGO = [
|
|
3
|
+
' ▄▄ ▄▄ ',
|
|
4
|
+
' ████▄ ▄████ ',
|
|
5
|
+
' ████▀██▄ ▄██▀████ ',
|
|
6
|
+
' ████ ▀██▄▄ ▄▄██▀ ████ ',
|
|
7
|
+
' ▀███ ▀▀██▄ ██ ▄██▀▀ ███▀ ',
|
|
8
|
+
' ███▄ ▀███▄▀▀▄███▀ ▄███ ',
|
|
9
|
+
' ███ ▀██████▀ ███ ',
|
|
10
|
+
' ███ ▀▀ ███ ',
|
|
11
|
+
' ▀██▄ ▄ ▄ ▄██▀ ',
|
|
12
|
+
' ██████▄ ▄██████ ',
|
|
13
|
+
' ▀█▀██▄ ▄████▀ ',
|
|
14
|
+
' ▀███ ███▀ ',
|
|
15
|
+
' ▀███▄▄███▀ ',
|
|
16
|
+
' ██████ ',
|
|
17
|
+
' ▀██▀ ',
|
|
18
|
+
' ▀▀ ',
|
|
19
|
+
]
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
"""GMaps Scout from the command line.
|
|
2
|
+
|
|
3
|
+
Example:
|
|
4
|
+
python cli.py "coffee shop in Bali" --limit 20 --out leads.xlsx
|
|
5
|
+
"""
|
|
6
|
+
import argparse
|
|
7
|
+
import csv
|
|
8
|
+
import sys
|
|
9
|
+
import time
|
|
10
|
+
|
|
11
|
+
from gmapscout_core import COLUMNS, scrape
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def main():
|
|
15
|
+
p = argparse.ArgumentParser(description="Turn publicly listed business details into a spreadsheet (Vulpfest Lab).")
|
|
16
|
+
p.add_argument("query", help='what to search for on Google Maps, e.g. "coffee shop in Bali"')
|
|
17
|
+
p.add_argument("--limit", type=int, default=20, help="maximum number of places (default 20, up to 200)")
|
|
18
|
+
p.add_argument("--out", metavar="FILE", help="save as .xlsx or .csv")
|
|
19
|
+
p.add_argument("--show-browser", action="store_true", help="show the browser window instead of running headless")
|
|
20
|
+
a = p.parse_args()
|
|
21
|
+
print("Reminder: collect only publicly listed business information and follow the terms of the sites you use.", file=sys.stderr)
|
|
22
|
+
|
|
23
|
+
def log(msg, type="info"):
|
|
24
|
+
print(f"[{time.strftime('%H:%M:%S')}] {type.upper():<7} {msg.replace('**', '')}", file=sys.stderr)
|
|
25
|
+
|
|
26
|
+
def progress(phase, current, total):
|
|
27
|
+
if phase == "extract":
|
|
28
|
+
print(f" reading {current}/{total}", end="\r", file=sys.stderr)
|
|
29
|
+
|
|
30
|
+
rows = scrape(a.query, max(1, min(a.limit, 200)), headless=not a.show_browser, log=log, on_progress=progress)
|
|
31
|
+
if not rows:
|
|
32
|
+
print("No data retrieved.", file=sys.stderr)
|
|
33
|
+
return 1
|
|
34
|
+
if a.out and a.out.lower().endswith(".xlsx"):
|
|
35
|
+
import pandas as pd
|
|
36
|
+
pd.DataFrame(rows, columns=COLUMNS).to_excel(a.out, index=False, sheet_name="Leads")
|
|
37
|
+
elif a.out:
|
|
38
|
+
with open(a.out, "w", newline="", encoding="utf-8-sig") as f:
|
|
39
|
+
w = csv.DictWriter(f, fieldnames=COLUMNS)
|
|
40
|
+
w.writeheader()
|
|
41
|
+
w.writerows(rows)
|
|
42
|
+
else:
|
|
43
|
+
for r in rows:
|
|
44
|
+
print(f"{r['Entity Name']}\t{r['Contact Number']}\t{r['Website URL']}\t{r['Address']}")
|
|
45
|
+
if a.out:
|
|
46
|
+
print(f"Saved {len(rows)} places to {a.out}", file=sys.stderr)
|
|
47
|
+
return 0
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
if __name__ == "__main__":
|
|
51
|
+
sys.exit(main())
|