{"id":30606198,"url":"https://github.com/PatriikPlays/findshop","last_synced_at":"2025-08-30T03:02:29.783Z","repository":{"id":178747633,"uuid":"662205253","full_name":"PatriikPlays/findshop","owner":"PatriikPlays","description":"A SC3 chatbox service to find ShopSync compatible shops ","archived":false,"fork":false,"pushed_at":"2025-08-27T23:58:08.000Z","size":445,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-08-28T05:17:51.810Z","etag":null,"topics":["chatbox","shopsync","switchcraft3"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PatriikPlays.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-04T15:25:12.000Z","updated_at":"2025-08-27T23:58:11.000Z","dependencies_parsed_at":"2024-02-06T19:25:10.015Z","dependency_job_id":"f0c19a47-b205-4eb9-8646-013f550b708c","html_url":"https://github.com/PatriikPlays/findshop","commit_stats":null,"previous_names":["slimit75/fs-chatbox","pixium/findshop","erb3/findshop","piprett/findshop","patriikplays/findshop"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/PatriikPlays/findshop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatriikPlays%2Ffindshop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatriikPlays%2Ffindshop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatriikPlays%2Ffindshop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatriikPlays%2Ffindshop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PatriikPlays","download_url":"https://codeload.github.com/PatriikPlays/findshop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatriikPlays%2Ffindshop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272797078,"owners_count":24994522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbox","shopsync","switchcraft3"],"created_at":"2025-08-30T03:01:22.468Z","updated_at":"2025-08-30T03:02:29.767Z","avatar_url":"https://github.com/PatriikPlays.png","language":"TypeScript","funding_links":[],"categories":["Programs"],"sub_categories":["External Software"],"readme":"\u003ch1 align=\"center\"\u003e FindShop \u003c/h1\u003e\n\u003cp align=\"center\"\u003ePowerful SwitchCraft service to \u003cstrong\u003efind shops and items!\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"GitHub top language\" src=\"https://img.shields.io/github/languages/top/Erb3/FindShop?style=flat-square\"\u003e\n  \u003cimg alt=\"GitHub Repo stars\" src=\"https://img.shields.io/github/stars/Erb3/FindShop?style=flat-square\"\u003e\n  \u003cimg alt=\"GitHub contributors\" src=\"https://img.shields.io/github/contributors/Erb3/FindShop?style=flat-square\"\u003e\n  \u003cimg alt=\"GitHub Created At\" src=\"https://img.shields.io/github/created-at/Erb3/FindShop?style=flat-square\"\u003e\n\u003c/p\u003e\n\n\u003chr\u003e\n\nFindShop is a SwitchCraft service providing an easy way to search for compatible\nshops implementing the [ShopSync] protocol. Default command aliases are `\\fs` or `\\findshop`.\n\n## FAQ\n\n### Supported servers\n\nCurrently, findshop only runs on [ReconnectedCC](https://reconnected.cc/). The aliases being used are `\\fsl` and `\\findshoplegacy`, and the HTTP API runs at https://rcc.findshop.patriik.one/api/.\n\n### Why are shops or items missing?\n\nThere are a few reasons why your search results may not be what you expected,\nsuch as the following.\n\n#### The search term may be too specific or misspelled\n\nFindShop matches results based on exact matches to an item name (display name\nand item id). So, for example, if you were searching for slime blocks\n(`minecraft:slime_block`):\n\n- `slime` would be matched to both the display name (\"**Slime** Block\") and the\n  item ID (minecraft:**slime**\\_block)\n- `slime_block` would be matched to the item ID (minecraft:**slime_block**)\n  between \"slime\" and \"block\" and the item ID replaces this space with an\n- `slimeblock` would return **NOTHING** because the display name has a space in\n  underscore.\n\n#### FindShop doesn't have the shop\n\nFindShop fetches shop information, including location, pricing \u0026 stock, from\nshops implementing the [ShopSync] standard. Shops might not appear if:\n\n- their software doesn't support ShopSync\n- their software implemented ShopSync incorrectly\n- their shop hasn't been configured to use ShopSync\n- their shop hasn't been loaded recently\n- something is broken on our end\n\n### What softwares support ShopSync?\n\n\u003e [!NOTE]\n\u003e If there are others, feel free to submit a PR.\n\n| Software                                         | Version  | ShopSync Standard (in latest version) | Note                                                |\n| ------------------------------------------------ | -------- | ------------------------------------- | --------------------------------------------------- |\n| [Kristify](https://github.com/Kristify/Kristify) | \u003e=1.3.0  | 1.1                                   | Earlier versions may use an older ShopSync standard |\n| [Radon](https://github.com/Allymonies/Radon)     | \u003e=1.3.30 | 1.1                                   | Most common shop software                           |\n\n## Subcommands\n\n### Buy\n\n```chat\n\\fs buy [[=]item] [page]\n```\n\nFinds shops with `[item]` and returns the shop name, location, item price \u0026\nquantity in stock. The buy keyword is optional: if no subcommand is specified,\nbuy is inferred. If `[item]` is prefixed with `=`, an exact query is performed.\n\n### Sell\n\n```chat\n\\fs sell [[=]item] [page]\n```\n\nFinds shops buying `[item]` and returns the shop name, location and item price. If `[item]` is prefixed with `=`, an exact query is performed.\n\n### Shop Details\n\n```chat\n\\fs shop \u003cid\u003e [page]\n```\n\nFinds shops with `\u003cid\u003e` and returns the owner, location, and other statistics.\n\n### Stats\n\n```chat\n\\fs stats\n```\n\nReturns some statistics.\n\n### List\n\n```chat\n\\fs list [page]\n```\n\nLists all available shops.\n\n## HTTP API\n\n### `/v1/`\n\u003e `/v1/items`\n\u003e ```\n\u003e Query params (optional):\n\u003e\n\u003e query: string query\n\u003e exact: true/false\n\u003e inStock: true/false\n\u003e sell: true/false\n\u003e includeFullShop: true/false\n\u003e ```\n\n\u003e `/v1/shop/:id`\n\u003e ```\n\u003e Query params (optional):\n\u003e\n\u003e includeItems: true/false\n\u003e ```\n\n## Deployment\n\nYou must use a reverse-proxy like [Nginx](https://nginx.org/) or\n[Caddy](https://caddyserver.com/) to rate-limit, log, and protect the API.\nThe IP of the client must be set in the `X-Forwarded-For` header. The proxy must\nnot accept any pre-existing value in the header, and should always overwrite it.\n\n## Contributing\n\nFindShop is developed using the [Bun toolkit and runtime](https://bun.com).\n\n[ShopSync]: https://p.sc3.io/7Ae4KxgzAM\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPatriikPlays%2Ffindshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPatriikPlays%2Ffindshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPatriikPlays%2Ffindshop/lists"}