Skip to content

Commit ca6971d

Browse files
committed
docs: add a 'try it live' scraping example against the practice lab
Document scraping this project's own GitHub Pages site (which hosts the hidden lab) in both the README and the website (new protocol_05 card), so anyone can try the full scrape -> analyze flow and recover the planted metadata.
1 parent f7d77f1 commit ca6971d

2 files changed

Lines changed: 23 additions & 0 deletions

File tree

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -243,6 +243,15 @@ jq '.unique.Author' MetaDetective_Export-*.json
243243

244244
MetaDetective can crawl a target website, discover downloadable files (PDF, DOCX, XLSX, images, etc.), and download them for local metadata analysis.
245245

246+
**Try it live** — this project's own site hosts a hidden practice lab (metadata-rich sample documents). Point MetaDetective at it and analyze what comes back:
247+
248+
```bash
249+
python3 MetaDetective.py https://franckferman.github.io/MetaDetective/
250+
python3 MetaDetective.py ./loot/ --summary
251+
```
252+
253+
You'll recover planted identities, emails, tools, and GPS coordinates. (Keep the trailing slash, or use a version >= the post-2.0.6 fix that follows the redirect.)
254+
246255
**Two scraping modes:**
247256

248257
- **`--download-dir`** - Download files to a local directory for analysis. This is the primary mode.

docs/website/index.html

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -717,6 +717,20 @@ <h2>Investigation Protocols</h2>
717717
</div>
718718
</div>
719719

720+
<div class="protocol-card">
721+
<div class="protocol-head">
722+
<span class="dot dot-r"></span><span class="dot dot-y"></span><span class="dot dot-g"></span>
723+
<span class="protocol-title">protocol_05 :: try it live</span>
724+
</div>
725+
<div class="protocol-body">
726+
<pre><span class="cm"># Scrape this very site - it hides a practice lab</span>
727+
<span class="cp">$ </span><span class="cc">python3 MetaDetective.py</span> <span class="cv">https://franckferman.github.io/MetaDetective/</span>
728+
729+
<span class="cm"># Analyze what you recovered (identities, emails, GPS...)</span>
730+
<span class="cp">$ </span><span class="cc">python3 MetaDetective.py</span> <span class="cv">./loot/</span> <span class="cf">--summary</span></pre>
731+
</div>
732+
</div>
733+
720734
</div>
721735
</div>
722736
</section>

0 commit comments

Comments
 (0)