CrackDiggerEngine 2.0.0

<div align="center">

CrackDiggerEngine

Search game listings on several public game sites from .NET.

© 2025–present · @m51v5 · m51v5.com

</div>

CrackDiggerEngine is a .NET library that searches game listing sites for a keyword and returns each result's title, link and image. Search one site, a few, or all of them at once.

Features

• Several sites, one API: pick a site from an enum, or search them all.
• Clean results: every result has a title, a link and an image address, never null.
• Errors as data: a site that fails returns isSuccess = false and an ErrorMessage, so one broken site doesn't stop the others.
• Ready for JSON: map results to dictionaries in one call.
• Light: one dependency, HtmlAgilityPack.

Install

dotnet add package CrackDiggerEngine

Needs .NET 8 or newer. Package page: nuget.org/packages/CrackDiggerEngine.

Quick start

using CrackDigger;

var result = await CrackDiggerEngine.FindGameAsync(CrackDiggerEngine.enSiteUri.ovaGamesDotCom, "witcher 3");

if (result.isSuccess)
{
    foreach (var game in result.Data!)
    {
        Console.WriteLine($"{game.Title}: {game.GameLink}");
    }
}
else
{
    Console.WriteLine($"Error: {result.ErrorMessage}");
}

Search every site at once:

var all = await CrackDiggerEngine.FindGameAllSitesAsync("witcher 3");

foreach (var (site, games) in all)
{
    Console.WriteLine($"{site}: {(games.isSuccess ? games.Data!.Count() + " results" : games.ErrorMessage)}");
}

Supported sites

CrackDiggerEngine.getSuporttedSites returns the same list as a dictionary of enum value to domain.

API

All members are on the static class CrackDiggerEngine, in the CrackDigger namespace.

Search

Sites are searched one after another. Each search sends one request to that site.

Results

clsGames, one site's search:

clsGameDataObject, one result: Title, GameLink, ImageLink. Each is an empty string when the site didn't provide it.

Both classes are created by the library only.

Mapping

Each dictionary has the keys title, link and image:

var rows = await CrackDiggerEngine.MapAllGamesDataAsync(result.Data!);
string json = System.Text.Json.JsonSerializer.Serialize(rows);

Privacy

Each search sends one request to that site's search page, with your keyword in the address and a User-Agent naming the library. Nothing goes anywhere else, and nothing is saved. Results come from third-party pages, so treat them as untrusted input. Details are in SECURITY.md.

Documentation

• Development guide: building, checks, adding or fixing a site, and publishing a release.

Build from source

You need the .NET 8 SDK.

git clone https://github.com/m51v5/CrackDiggerEngine.git
cd CrackDiggerEngine
dotnet build CrackDiggerEngine.sln

Notes

• Moving from CrackDiggerEngineByM51V5: that package ID is deprecated. Run dotnet remove package CrackDiggerEngineByM51V5, then dotnet add package CrackDiggerEngine, and change using CrackDiggerEngineByM51V5; to using CrackDigger;. Class and method names are the same.
• Sites change their pages without notice, so a site can stop working between releases. Check isSuccess and ErrorMessage on every result.

Disclaimer

This library works like a search engine: it shows only information that the sites make public. It doesn't claim ownership of that information, which belongs to its owners. It stores nothing and isn't meant to be used against intellectual property or DRM rules.

Contributing and support

• Found a bug, a broken site, or have an idea? Open an issue.
• Want to help? Read the contributing guide and the code of conduct.
• Found a security problem? See SECURITY.md.
• Other ways to reach me: m51v5.com/contact.

License

MIT © @m51v5