consensus-osint 0.4.2__tar.gz → 0.4.4__tar.gz

{consensus_osint-0.4.2 → consensus_osint-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: consensus-osint
-Version: 0.4.2
+Version: 0.4.4
 Summary: Expert-maintained username, email and phone intelligence with 7,900+ standardised lookup modules from 19 open-source projects.
 Author: OSINT Experts Society
 License-Expression: GPL-3.0-or-later
@@ -77,14 +77,14 @@ Dynamic: license-file
 
 <p align="center">By the <a href="https://osint.ngo">OSINT Experts Society</a></p>
 
-<p align="center">A unified lookup tool combining 7,900+ modules from 19 open-source projects, reviewed and updated weekly by our experts.</p>
+<p align="center">A unified lookup tool combining 7,900+ modules from 19 open-source projects, maintained by our experts, with a weekly review target.</p>
 
 <p align="center"><a href="#install"><strong>Install</strong></a> &middot; <a href="#see-consensus-in-action">See it in action</a> &middot; <a href="#key-features">Features</a> &middot; <a href="#compare">Compare</a></p>
 
 <p align="center">
   <a href="#compare"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-projects.svg" alt="19 projects combined" height="24"></a>
   <a href="#key-features"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-modules.svg" alt="7,900+ lookup modules" height="24"></a>
-  <a href="#why-consensus"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-review.svg" alt="Expert review: weekly" height="24"></a>
+  <a href="#why-consensus"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-review.svg" alt="Expert review: weekly target" height="24"></a>
 </p>
 
 <p align="center">
@@ -98,7 +98,7 @@ Dynamic: license-file
     <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-dark-mobile.svg">
     <source media="(max-width: 600px)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-light-mobile.svg">
     <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-dark.svg">
-    <img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-light.svg" width="920" alt="How Consensus works: 19 source projects list 12,356 modules and rules including overlaps; expert review tests, improves, standardises and deduplicates candidates before 7,989 enabled modules and rules enter Consensus. Experts review and update Consensus weekly. Default searches select relevant modules, remove duplicate routes and present unified results.">
+    <img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-light.svg" width="920" alt="How Consensus works: 19 source projects list 12,356 modules and rules including overlaps; expert review tests, improves, standardises and deduplicates candidates before 7,989 enabled modules and rules enter Consensus. Experts aim to review sources weekly; the latest completed review is dated below. Default searches select relevant modules, remove duplicate routes and present unified results.">
   </picture>
 </p>
 
@@ -123,7 +123,7 @@ Dynamic: license-file
     <tr><th align="left">Tool</th><th align="center">Username</th><th align="center">Email</th><th align="center">Phone</th><th align="center">Duplicate<br>ratio</th><th align="center">Update<br>frequency</th><th align="center">Last&nbsp;module<br>update</th></tr>
   </thead>
   <tbody>
-    <tr><td align="left"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-dark.svg"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-light.svg" width="120" alt="Consensus"></picture><br><strong>Combined solution</strong></td><td align="center"><strong>7,782</strong></td><td align="center"><strong>205</strong></td><td align="center"><strong>2</strong></td><td align="center"><strong>Deduplicated</strong><br><sub>default searches</sub></td><td align="center"><strong>Weekly<br>expert review</strong></td><td align="center">02&nbsp;Oct&nbsp;2026</td></tr>
+    <tr><td align="left"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-dark.svg"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-light.svg" width="120" alt="Consensus"></picture><br><strong>Combined solution</strong></td><td align="center"><strong>7,782</strong></td><td align="center"><strong>205</strong></td><td align="center"><strong>2</strong></td><td align="center"><strong>Deduplicated</strong><br><sub>default searches</sub></td><td align="center"><strong>Weekly review<br>target</strong></td><td align="center">02&nbsp;Oct&nbsp;2026</td></tr>
     <tr><td align="left"><a href="https://github.com/soxoj/maigret/tree/b6642744988e7e6c2d21f75db60ec3093019ba25">Maigret</a></td><td align="center">5,483</td><td align="center">—</td><td align="center">—</td><td align="center"><strong>40.8%</strong><br><sub>5,482/5,483&nbsp;mapped</sub></td><td align="center">Every&nbsp;2&nbsp;days</td><td align="center"><a href="https://github.com/soxoj/maigret/commit/3d2b613cfd9a18bebc9d65bb22bcf8af13aa18ef">25&nbsp;Sep&nbsp;2026</a></td></tr>
     <tr><td align="left"><a href="https://github.com/kaifcodec/user-scanner/tree/780d077a468035c6afd6b4a0f987317db651528b">User Scanner</a></td><td align="center">2,511</td><td align="center">211</td><td align="center">—</td><td align="center"><strong>68.9%</strong><br><sub>2,575/2,722&nbsp;mapped</sub></td><td align="center">Every&nbsp;1&nbsp;day</td><td align="center"><a href="https://github.com/kaifcodec/user-scanner/commit/8f4de8e7b3e68672c50ba318b2d15a9d2b4617e9">29&nbsp;Sep&nbsp;2026</a></td></tr>
     <tr><td align="left"><a href="https://github.com/arxhr007/Aliens_eye/tree/b1316648fe0e648469d30512bb0535ebc8c4bbc7">Aliens Eye</a></td><td align="center">840</td><td align="center">—</td><td align="center">—</td><td align="center"><strong>65.4%</strong><br><sub>837/840&nbsp;mapped</sub></td><td align="center">Too few updates</td><td align="center"><a href="https://github.com/arxhr007/Aliens_eye/commit/eb10623492e1e171ff2d7d9cfc043a4a0a0e493a">10&nbsp;Jun&nbsp;2026</a></td></tr>
@@ -153,9 +153,10 @@ Dynamic: license-file
 
 ### Coverage and maintenance
 
-- **Expert review, every week.** Our team reviews all 19 source projects weekly and evaluates new OSINT projects as they emerge. Suitable modules are tested, improved and integrated; broken modules are retired.
+- **Expert-maintained coverage.** Our team aims to review all 19 source projects weekly and evaluates new OSINT projects as they emerge. The latest completed review is dated above. Suitable modules are tested, improved and integrated; broken modules are retired.
 - **Keep investigations current.** Search newly added lookup sources, or recheck saved identifiers and see newly discovered matches, changed details and inconclusive results.
-- **Quick first results.** Username menu searches start with up to 300 site and module lookups. Continue the full search while retaining completed results.
+- **Choose your search size.** Guided username and email searches offer **Quick** (up to 300 checks), **Custom** (enter a number) and **Full** (all eligible checks). Settings changes the default for this session; each search can override it. Eligible enrichment stays enabled, and email domain analysis is separate.
+- **Balanced limited searches.** `--top 500` and Quick aim for 50/50 site checks and modules, filling unused slots from the other group. Limits apply per username/email after exclusions; email's module-only plan uses the available modules. Stored ranks order each group, not verified current popularity. Modules do not guarantee returned enrichment. Continue the full search to add remaining coverage, or use `--full`.
 - **Automatic update checks.** Managed installs check for updates at startup and notify you when an update is available or ready to use. Repair and rollback are built in.
 
 ### Investigation workflow
@@ -219,12 +220,12 @@ The Windows install bundle is recommended for most users. It sets up Python and
 
 ### Other installation options
 
-For macOS, Linux or a terminal-based installation, use the options below.
+For macOS, Linux, PyPI or a terminal-based installation, use the options below.
 
-| Platform | Double-click installer | Install from terminal | Install from source |
-| --- | --- | --- | --- |
-| **Windows** | **Install.cmd** | Run `.\Install.cmd` in CMD or PowerShell. | [Git + Python instructions](#install-from-source) |
-| **macOS / Linux** | Use the terminal option. | Run `sh install.sh`. | [Git + Python instructions](#install-from-source) |
+| Platform | Double-click installer | Bundle from terminal | Install from PyPI | Install from source |
+| --- | --- | --- | --- | --- |
+| **Windows** | **Install.cmd** | Run `.\Install.cmd` in CMD or PowerShell. | [Python + PyPI instructions](#install-from-pypi) | [Git + Python instructions](#install-from-source) |
+| **macOS / Linux** | Use the terminal option. | Run `sh install.sh`. | [Python + PyPI instructions](#install-from-pypi) | [Git + Python instructions](#install-from-source) |
 
 Both bundle options set up Python and dependencies for you. Run terminal commands from the extracted folder. Internet access is required.
 
@@ -234,6 +235,17 @@ After a bundle install, open a new terminal:
 consensus
 ```
 
+### Install from PyPI
+
+Already have Python 3.10 or newer? Install Consensus with its lookup modules and PDF reporting:
+
+```console
+python -m pip install "consensus-osint[modules,pdf]"
+consensus
+```
+
+Use `py` instead of `python` on Windows, or `python3` on macOS/Linux, if required.
+
 ## Start searching
 
 1. Choose **Username**, **Email**, **Phone** or **Bulk search**.
@@ -258,10 +270,18 @@ Explore more with `consensus --help` or `consensus examples`.
 
 </details>
 
-## Manage your installation
+## Update Consensus
+
+| Installed with | How to update |
+| --- | --- |
+| **Windows, macOS or Linux installer** | Run `consensus update`. |
+| **PyPI** | Run `python -m pip install --upgrade "consensus-osint[modules,pdf]"`. |
+| **Git / source** | Run `git pull`, then repeat the platform install command under [Install from source](#install-from-source). |
+
+Restart Consensus after updating. Installer-based installations also check for updates when Consensus starts and install them automatically by default.
 
 <details>
-<summary><strong>Updates, repair and migration</strong></summary>
+<summary><strong>Repair, rollback and update controls</strong></summary>
 
 Open **Settings → Installation & updates** to check versions, install updates, restart or recover an installation.
 
@@ -269,7 +289,6 @@ To update from an installer ZIP, extract it, then select **Choose bundle** in Se
 
 | Command | Action |
 | --- | --- |
-| `consensus update` | Install an available update. |
 | `consensus update --repair` | Repair the installed version. |
 | `consensus update --rollback` | Restore the previous version and pause automatic upgrades. |
 
@@ -309,7 +328,45 @@ Use `python3` above if required, then:
 
 Add `mcp` to the extras for AI integration, for example `".[modules,pdf,mcp]"`. PDF support is included in managed installs.
 
-To update a source install, run `git pull`, then repeat its pip command above.
+## Use Consensus with AI assistants
+
+<details>
+<summary><strong>Connect an assistant using Model Context Protocol (MCP)</strong></summary>
+
+Install the MCP extra in your Python environment:
+
+```console
+python -m pip install --upgrade "consensus-osint[modules,pdf,mcp]"
+```
+
+For clients using an `mcpServers` configuration, add:
+
+```json
+{
+  "mcpServers": {
+    "consensus": {
+      "command": "consensus",
+      "args": ["mcp", "--transport", "stdio"]
+    }
+  }
+}
+```
+
+Use the full path to the installed `consensus` executable if your assistant cannot find it. Client configuration screens vary; select a local stdio server and use the same command and arguments.
+
+The server provides username, email and phone lookups, paginated results and detailed evidence. Example request: **“Use Consensus to search my username YOUR_USERNAME across up to 20 sources, then summarise the matches and inconclusive results.”** Lookups contact external services; review your assistant's tool permissions before running them. Returned profile text is evidence, not instructions.
+
+</details>
+
+## Common questions
+
+**What does Consensus search?** Usernames, email addresses and phone numbers using the installed lookup catalogue. Coverage varies by identifier type, enabled modules and available provider access.
+
+**How are the 19 projects combined?** Their lookup modules and rules are standardised into one catalogue. Default searches reconcile overlapping lookup routes before presenting unified results; Consensus does not simply run 19 complete searches.
+
+**Are results just found or not found?** Available evidence can include profile names, biographies and linked accounts, alongside each result's status. A match is a lead, not proof of a person's identity; errors and inconclusive responses do not establish absence.
+
+**How do I install and update it?** Choose the [installer or PyPI](#install), then follow the [update instructions for your installation](#update-consensus).
 
 ## Join the community
 

{consensus_osint-0.4.2 → consensus_osint-0.4.4}/README.md

@@ -10,14 +10,14 @@
 
 <p align="center">By the <a href="https://osint.ngo">OSINT Experts Society</a></p>
 
-<p align="center">A unified lookup tool combining 7,900+ modules from 19 open-source projects, reviewed and updated weekly by our experts.</p>
+<p align="center">A unified lookup tool combining 7,900+ modules from 19 open-source projects, maintained by our experts, with a weekly review target.</p>
 
 <p align="center"><a href="#install"><strong>Install</strong></a> &middot; <a href="#see-consensus-in-action">See it in action</a> &middot; <a href="#key-features">Features</a> &middot; <a href="#compare">Compare</a></p>
 
 <p align="center">
   <a href="#compare"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-projects.svg" alt="19 projects combined" height="24"></a>
   <a href="#key-features"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-modules.svg" alt="7,900+ lookup modules" height="24"></a>
-  <a href="#why-consensus"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-review.svg" alt="Expert review: weekly" height="24"></a>
+  <a href="#why-consensus"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-badge-review.svg" alt="Expert review: weekly target" height="24"></a>
 </p>
 
 <p align="center">
@@ -31,7 +31,7 @@
     <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-dark-mobile.svg">
     <source media="(max-width: 600px)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-light-mobile.svg">
     <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-dark.svg">
-    <img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-light.svg" width="920" alt="How Consensus works: 19 source projects list 12,356 modules and rules including overlaps; expert review tests, improves, standardises and deduplicates candidates before 7,989 enabled modules and rules enter Consensus. Experts review and update Consensus weekly. Default searches select relevant modules, remove duplicate routes and present unified results.">
+    <img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-process-light.svg" width="920" alt="How Consensus works: 19 source projects list 12,356 modules and rules including overlaps; expert review tests, improves, standardises and deduplicates candidates before 7,989 enabled modules and rules enter Consensus. Experts aim to review sources weekly; the latest completed review is dated below. Default searches select relevant modules, remove duplicate routes and present unified results.">
   </picture>
 </p>
 
@@ -56,7 +56,7 @@
     <tr><th align="left">Tool</th><th align="center">Username</th><th align="center">Email</th><th align="center">Phone</th><th align="center">Duplicate<br>ratio</th><th align="center">Update<br>frequency</th><th align="center">Last&nbsp;module<br>update</th></tr>
   </thead>
   <tbody>
-    <tr><td align="left"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-dark.svg"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-light.svg" width="120" alt="Consensus"></picture><br><strong>Combined solution</strong></td><td align="center"><strong>7,782</strong></td><td align="center"><strong>205</strong></td><td align="center"><strong>2</strong></td><td align="center"><strong>Deduplicated</strong><br><sub>default searches</sub></td><td align="center"><strong>Weekly<br>expert review</strong></td><td align="center">02&nbsp;Oct&nbsp;2026</td></tr>
+    <tr><td align="left"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-dark.svg"><img src="https://raw.githubusercontent.com/OSINT-Experts-Society/Consensus-OSINT/main/consensus_osint/templates/consensus-wordmark-light.svg" width="120" alt="Consensus"></picture><br><strong>Combined solution</strong></td><td align="center"><strong>7,782</strong></td><td align="center"><strong>205</strong></td><td align="center"><strong>2</strong></td><td align="center"><strong>Deduplicated</strong><br><sub>default searches</sub></td><td align="center"><strong>Weekly review<br>target</strong></td><td align="center">02&nbsp;Oct&nbsp;2026</td></tr>
     <tr><td align="left"><a href="https://github.com/soxoj/maigret/tree/b6642744988e7e6c2d21f75db60ec3093019ba25">Maigret</a></td><td align="center">5,483</td><td align="center">—</td><td align="center">—</td><td align="center"><strong>40.8%</strong><br><sub>5,482/5,483&nbsp;mapped</sub></td><td align="center">Every&nbsp;2&nbsp;days</td><td align="center"><a href="https://github.com/soxoj/maigret/commit/3d2b613cfd9a18bebc9d65bb22bcf8af13aa18ef">25&nbsp;Sep&nbsp;2026</a></td></tr>
     <tr><td align="left"><a href="https://github.com/kaifcodec/user-scanner/tree/780d077a468035c6afd6b4a0f987317db651528b">User Scanner</a></td><td align="center">2,511</td><td align="center">211</td><td align="center">—</td><td align="center"><strong>68.9%</strong><br><sub>2,575/2,722&nbsp;mapped</sub></td><td align="center">Every&nbsp;1&nbsp;day</td><td align="center"><a href="https://github.com/kaifcodec/user-scanner/commit/8f4de8e7b3e68672c50ba318b2d15a9d2b4617e9">29&nbsp;Sep&nbsp;2026</a></td></tr>
     <tr><td align="left"><a href="https://github.com/arxhr007/Aliens_eye/tree/b1316648fe0e648469d30512bb0535ebc8c4bbc7">Aliens Eye</a></td><td align="center">840</td><td align="center">—</td><td align="center">—</td><td align="center"><strong>65.4%</strong><br><sub>837/840&nbsp;mapped</sub></td><td align="center">Too few updates</td><td align="center"><a href="https://github.com/arxhr007/Aliens_eye/commit/eb10623492e1e171ff2d7d9cfc043a4a0a0e493a">10&nbsp;Jun&nbsp;2026</a></td></tr>
@@ -86,9 +86,10 @@
 
 ### Coverage and maintenance
 
-- **Expert review, every week.** Our team reviews all 19 source projects weekly and evaluates new OSINT projects as they emerge. Suitable modules are tested, improved and integrated; broken modules are retired.
+- **Expert-maintained coverage.** Our team aims to review all 19 source projects weekly and evaluates new OSINT projects as they emerge. The latest completed review is dated above. Suitable modules are tested, improved and integrated; broken modules are retired.
 - **Keep investigations current.** Search newly added lookup sources, or recheck saved identifiers and see newly discovered matches, changed details and inconclusive results.
-- **Quick first results.** Username menu searches start with up to 300 site and module lookups. Continue the full search while retaining completed results.
+- **Choose your search size.** Guided username and email searches offer **Quick** (up to 300 checks), **Custom** (enter a number) and **Full** (all eligible checks). Settings changes the default for this session; each search can override it. Eligible enrichment stays enabled, and email domain analysis is separate.
+- **Balanced limited searches.** `--top 500` and Quick aim for 50/50 site checks and modules, filling unused slots from the other group. Limits apply per username/email after exclusions; email's module-only plan uses the available modules. Stored ranks order each group, not verified current popularity. Modules do not guarantee returned enrichment. Continue the full search to add remaining coverage, or use `--full`.
 - **Automatic update checks.** Managed installs check for updates at startup and notify you when an update is available or ready to use. Repair and rollback are built in.
 
 ### Investigation workflow
@@ -152,12 +153,12 @@ The Windows install bundle is recommended for most users. It sets up Python and
 
 ### Other installation options
 
-For macOS, Linux or a terminal-based installation, use the options below.
+For macOS, Linux, PyPI or a terminal-based installation, use the options below.
 
-| Platform | Double-click installer | Install from terminal | Install from source |
-| --- | --- | --- | --- |
-| **Windows** | **Install.cmd** | Run `.\Install.cmd` in CMD or PowerShell. | [Git + Python instructions](#install-from-source) |
-| **macOS / Linux** | Use the terminal option. | Run `sh install.sh`. | [Git + Python instructions](#install-from-source) |
+| Platform | Double-click installer | Bundle from terminal | Install from PyPI | Install from source |
+| --- | --- | --- | --- | --- |
+| **Windows** | **Install.cmd** | Run `.\Install.cmd` in CMD or PowerShell. | [Python + PyPI instructions](#install-from-pypi) | [Git + Python instructions](#install-from-source) |
+| **macOS / Linux** | Use the terminal option. | Run `sh install.sh`. | [Python + PyPI instructions](#install-from-pypi) | [Git + Python instructions](#install-from-source) |
 
 Both bundle options set up Python and dependencies for you. Run terminal commands from the extracted folder. Internet access is required.
 
@@ -167,6 +168,17 @@ After a bundle install, open a new terminal:
 consensus
 ```
 
+### Install from PyPI
+
+Already have Python 3.10 or newer? Install Consensus with its lookup modules and PDF reporting:
+
+```console
+python -m pip install "consensus-osint[modules,pdf]"
+consensus
+```
+
+Use `py` instead of `python` on Windows, or `python3` on macOS/Linux, if required.
+
 ## Start searching
 
 1. Choose **Username**, **Email**, **Phone** or **Bulk search**.
@@ -191,10 +203,18 @@ Explore more with `consensus --help` or `consensus examples`.
 
 </details>
 
-## Manage your installation
+## Update Consensus
+
+| Installed with | How to update |
+| --- | --- |
+| **Windows, macOS or Linux installer** | Run `consensus update`. |
+| **PyPI** | Run `python -m pip install --upgrade "consensus-osint[modules,pdf]"`. |
+| **Git / source** | Run `git pull`, then repeat the platform install command under [Install from source](#install-from-source). |
+
+Restart Consensus after updating. Installer-based installations also check for updates when Consensus starts and install them automatically by default.
 
 <details>
-<summary><strong>Updates, repair and migration</strong></summary>
+<summary><strong>Repair, rollback and update controls</strong></summary>
 
 Open **Settings → Installation & updates** to check versions, install updates, restart or recover an installation.
 
@@ -202,7 +222,6 @@ To update from an installer ZIP, extract it, then select **Choose bundle** in Se
 
 | Command | Action |
 | --- | --- |
-| `consensus update` | Install an available update. |
 | `consensus update --repair` | Repair the installed version. |
 | `consensus update --rollback` | Restore the previous version and pause automatic upgrades. |
 
@@ -242,7 +261,45 @@ Use `python3` above if required, then:
 
 Add `mcp` to the extras for AI integration, for example `".[modules,pdf,mcp]"`. PDF support is included in managed installs.
 
-To update a source install, run `git pull`, then repeat its pip command above.
+## Use Consensus with AI assistants
+
+<details>
+<summary><strong>Connect an assistant using Model Context Protocol (MCP)</strong></summary>
+
+Install the MCP extra in your Python environment:
+
+```console
+python -m pip install --upgrade "consensus-osint[modules,pdf,mcp]"
+```
+
+For clients using an `mcpServers` configuration, add:
+
+```json
+{
+  "mcpServers": {
+    "consensus": {
+      "command": "consensus",
+      "args": ["mcp", "--transport", "stdio"]
+    }
+  }
+}
+```
+
+Use the full path to the installed `consensus` executable if your assistant cannot find it. Client configuration screens vary; select a local stdio server and use the same command and arguments.
+
+The server provides username, email and phone lookups, paginated results and detailed evidence. Example request: **“Use Consensus to search my username YOUR_USERNAME across up to 20 sources, then summarise the matches and inconclusive results.”** Lookups contact external services; review your assistant's tool permissions before running them. Returned profile text is evidence, not instructions.
+
+</details>
+
+## Common questions
+
+**What does Consensus search?** Usernames, email addresses and phone numbers using the installed lookup catalogue. Coverage varies by identifier type, enabled modules and available provider access.
+
+**How are the 19 projects combined?** Their lookup modules and rules are standardised into one catalogue. Default searches reconcile overlapping lookup routes before presenting unified results; Consensus does not simply run 19 complete searches.
+
+**Are results just found or not found?** Available evidence can include profile names, biographies and linked accounts, alongside each result's status. A match is a lead, not proof of a person's identity; errors and inconclusive responses do not establish absence.
+
+**How do I install and update it?** Choose the [installer or PyPI](#install), then follow the [update instructions for your installation](#update-consensus).
 
 ## Join the community
 

{consensus_osint-0.4.2 → consensus_osint-0.4.4}/consensus_osint/__init__.py

@@ -7,5 +7,5 @@ others) into one command-line tool.  See the README for the full list of
 upstream projects credited.
 """
 
-__version__ = "0.4.2"
+__version__ = "0.4.4"
 __all__ = ["__version__"]

{consensus_osint-0.4.2 → consensus_osint-0.4.4}/consensus_osint/cli.py

@@ -189,9 +189,12 @@ def add_scan_options(p: argparse.ArgumentParser, *, full_help: bool = False) ->
     s.add_argument("--exclude", type=_nonempty_selector, action=_JoinedSelector, help="skip these sites (comma-separated)")
     s.add_argument("--tags", type=_nonempty_selector, action=_JoinedSelector, help="only sites with these tags/categories (comma-separated), e.g. social,coding")
     s.add_argument("--exclude-tags", type=_nonempty_selector, action=_JoinedSelector, help="skip sites with these tags")
-    s.add_argument("--top", type=_positive_int, help="only the N most popular sites")
-    s.add_argument("--fast", action="store_true",
-                   help="start with up to 300 username site and module lookups; --top overrides this limit")
+    s.add_argument("--top", type=_positive_int, help="maximum checks per username/email; aim for 50/50 sites/modules, filling unused slots; background analysis is separate")
+    speed = s.add_mutually_exclusive_group()
+    speed.add_argument("--fast", action="store_true",
+                       help="up to 300 username/email lookups; --top overrides this limit")
+    speed.add_argument("--full", action="store_false", dest="fast",
+                       help="all eligible username/email checks (no Quick limit)")
     s.add_argument("--nsfw", action="store_true", help="include NSFW sites and modules")
     s.add_argument("--all-sites", action="store_true", help="also list disabled sites, as skipped results with the reason; they are not contacted")
     s.add_argument("--source", type=_nonempty_selector, action=_JoinedSelector, help="only sites from these upstream lists (sherlock,maigret,wmn,...)")
@@ -223,7 +226,7 @@ def add_scan_options(p: argparse.ArgumentParser, *, full_help: bool = False) ->
 
     if not full_help:
         common = {"help", "help_all", "queries", "output", "all", "quiet", "verbose", "details", "no_color", "compare_queries",
-                  "site", "fast", "proxy", "timeout", "input"}
+                  "site", "top", "fast", "proxy", "timeout", "input"}
         for action in p._actions:
             if action.dest not in common:
                 action.help = argparse.SUPPRESS
@@ -502,10 +505,9 @@ class Scanner:
         if self.args.no_sites:
             return []
         db = self.sites_db()
-        top = self.args.top or (300 if getattr(self.args, "fast", False) else None)
         return db.select(ids=self._csv(self.args.site), exclude=self._csv(self.args.exclude), tags=self._csv(self.args.tags),
                          exclude_tags=self._csv(self.args.exclude_tags), include_nsfw=self.args.nsfw,
-                         include_disabled=self.args.all_sites, top=top, id_type=id_type,
+                         include_disabled=self.args.all_sites, id_type=id_type,
                          sources=self._csv(self.args.source), tor=self.tor)
 
     def select_modules(self, kind: str) -> list:
@@ -568,6 +570,7 @@ class Scanner:
 
     # ------------------------------------------------------------- scans
     async def scan_username(self, username: str, depth: int = 0, parent: str | None = None, id_type: str = "username") -> list:
+        from .core.modules import limit_plan
         from .core.runner import run_all
 
         sites = self.select_sites(id_type=id_type)
@@ -578,13 +581,13 @@ class Scanner:
             from .core.modules import reconcile_plan
 
             sites, modules, paired = reconcile_plan(sites, modules, ctx=self.ctx, query=username)
-        if getattr(self.args, "fast", False) and not self.args.top:
-            sites = sites[:300]
-            modules = modules[:max(0, 300 - len(sites))]
         if self.continuation:
             sites = self.continuation.select(username, id_type, sites, "site:")
             modules = self.continuation.select(username, id_type, modules, "module:")
             sites, modules = self.continuation.exclude_completed_alternatives(username, id_type, sites, modules, paired)
+        limit = self.args.top or (300 if getattr(self.args, "fast", False) else None)
+        if limit:
+            sites, modules = limit_plan(sites, modules, limit, self.sites_db().sites, paired)
         total = len(sites) + len(modules)
         # Switching every check off (--no-sites --no-modules) is a deliberate dry run;
         # a filter that happens to select nothing is a mistake worth explaining.
@@ -688,6 +691,11 @@ class Scanner:
             self.printer.warn("disposable e-mail domain")
         if modules is None:
             modules = self.select_modules("email")
+        limit = getattr(self.args, "top", None) or (300 if getattr(self.args, "fast", False) else None)
+        if limit:
+            from .core.modules import limit_plan
+
+            _, modules = limit_plan([], modules, limit, self.sites_db().sites)
         self.printer.activity("Scanning", self._tool_names([], modules))
         self.printer.message(f"   {len(modules)} sites being scanned for this email", "cyan")
         self.printer.start_progress(len(modules), f"checking {email}")

{consensus_osint-0.4.2 → consensus_osint-0.4.4}/consensus_osint/core/console_results.py

@@ -68,7 +68,10 @@ def result_pages(summary, *, show_all=False, limit=0, filters=None):
                            + ". F changes or clears filters. Saving keeps every outcome.", style=f"bold {ACCENT}"))
         out.print(Text(("Full search: " if filters else "") +
                        f"{len(matches)} found · {sum(has_details(f) for f in matches)} enriched · {len(findings)} outcomes"))
-        if summary.options.get("fast"):
+        if summary.options.get("top"):
+            out.print(Text(f"Search limit: up to {summary.options['top']} checks per username/email · "
+                           "I Follow up → Continue full search keeps completed results.", style=f"bold {ACCENT}"))
+        elif summary.options.get("fast"):
             out.print(Text("Quick search · I Follow up → Continue full search keeps completed results.", style=f"bold {ACCENT}"))
         if summary.options.get("continuation"):
             retained = summary.options["continuation"].get("retained_results", 0)