{"_id":"northcinder","_rev":"3-a461b26f046b786a92875187cd79ff8b","name":"northcinder","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.2":{"name":"northcinder","version":"0.1.2","keywords":["northcinder","mcp","shopping-agent","buyer-agent","local-first"],"license":"MIT","_id":"northcinder@0.1.2","maintainers":[{"name":"sajdgsa","email":"FernandaColebuz@legislator.com"}],"homepage":"https://github.com/jdshfhds/northcinder#readme","bugs":{"url":"https://github.com/jdshfhds/northcinder/issues"},"bin":{"northcinder":"bin/northcinder.js"},"dist":{"shasum":"42fcc3e570b078c1b364b1b6cfc522ab59ef7bb3","tarball":"https://registry.npmjs.org/northcinder/-/northcinder-0.1.2.tgz","fileCount":4,"integrity":"sha512-0SfYleqEsLYfYL5o9J/mfNsH5AVMK92erN+egAYR0UVBX6ahY/r9kxgR+7VIKTBbw76RJaxORnhk4UKK6H9MIQ==","signatures":[{"sig":"MEYCIQDdwKc92ouYMLi70NeowI+M8KHsfR2peqIVn9LDXahsRwIhAMeA/b1NRMbEgPBWos9XOzvdaafAPRE/7nHNp9M7UEg3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1791722},"type":"module","engines":{"node":">=20"},"gitHead":"819a9cf2383d88aa6ef4dde22ef76f5b0479980a","scripts":{"test":"node --test test/*.test.mjs","build":"node scripts/build.mjs","prepack":"node scripts/build.mjs"},"_npmUser":{"name":"sajdgsa","email":"FernandaColebuz@legislator.com"},"repository":{"url":"git+https://github.com/jdshfhds/northcinder.git","type":"git","directory":"northcinder"},"_npmVersion":"11.17.0","description":"Buyer-run shopping agent MCP server with neutral ranking, reasons, approval, and local audit","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.1"},"optionalDependencies":{"playwright-core":"^1.61.1"},"_npmOperationalInternal":{"tmp":"tmp/northcinder_0.1.2_1786965768443_0.4260631222902922","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"northcinder","version":"0.2.0","keywords":["northcinder","mcp","shopping-agent","buyer-agent","local-first"],"license":"MIT","_id":"northcinder@0.2.0","maintainers":[{"name":"sajdgsa","email":"FernandaColebuz@legislator.com"}],"homepage":"https://github.com/cinderline/northcinder#readme","bugs":{"url":"https://github.com/cinderline/northcinder/issues"},"bin":{"northcinder":"bin/northcinder.js"},"dist":{"shasum":"cf46401315ddcd5f85f9617c424fdf3206053fa4","tarball":"https://registry.npmjs.org/northcinder/-/northcinder-0.2.0.tgz","fileCount":6,"integrity":"sha512-YD9R28nlq3OEQN0Ff611A8BWDDEcrDrqi+udAYWDukDxeQVPccqyUk4/3EXLdyI0aAFbQqiKtNJRu5NVzue6pQ==","signatures":[{"sig":"MEUCIQD89mWLQfdrdUpJz7glbvW25Aj7qhREP/PJP6RNs8pCEAIgQIbfSiJWACk35XpYh8Tx/H6/+jaFN0q03McZnAvZSq8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2091435},"type":"module","_from":"file:northcinder-0.2.0.tgz","engines":{"node":">=20"},"scripts":{"test":"node --test --test-concurrency=1 test/*.test.mjs","build":"node scripts/build.mjs"},"_npmUser":{"name":"sajdgsa","email":"FernandaColebuz@legislator.com"},"_resolved":"/tmp/a50a6577f5f1ac2e788538e191aec90f/northcinder-0.2.0.tgz","_integrity":"sha512-YD9R28nlq3OEQN0Ff611A8BWDDEcrDrqi+udAYWDukDxeQVPccqyUk4/3EXLdyI0aAFbQqiKtNJRu5NVzue6pQ==","repository":{"url":"git+https://github.com/cinderline/northcinder.git","type":"git","directory":"northcinder"},"_npmVersion":"11.17.0","description":"NorthCinder is a buyer-run MCP shopping agent that compares evidence, explains tradeoffs, and asks before purchase","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.1"},"optionalDependencies":{"playwright-core":"^1.61.1"},"_npmOperationalInternal":{"tmp":"tmp/northcinder_0.2.0_1787393476385_0.37193912679376595","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"northcinder","version":"0.2.1","description":"NorthCinder is a buyer-run MCP shopping agent that compares evidence, explains tradeoffs, and asks before purchase","license":"MIT","type":"module","engines":{"node":">=20"},"keywords":["northcinder","mcp","shopping-agent","buyer-agent","local-first"],"repository":{"type":"git","url":"git+https://github.com/cinderline/northcinder.git","directory":"northcinder"},"homepage":"https://github.com/cinderline/northcinder#readme","bugs":{"url":"https://github.com/cinderline/northcinder/issues"},"publishConfig":{"access":"public"},"bin":{"northcinder":"bin/northcinder.js"},"scripts":{"build":"node scripts/build.mjs","prepack":"node scripts/build.mjs","test":"node --test --test-concurrency=1 test/*.test.mjs"},"optionalDependencies":{"playwright-core":"^1.61.1"},"devDependencies":{"esbuild":"^0.28.1"},"gitHead":"d1343096a7afff58e0aee4fbf608daf2fa28dc03","_id":"northcinder@0.2.1","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-u/VVZ4ALKrPjfHOlz2yi+MZ+JPadi9g7UDeviVQvMw7XP5dvorB1VUz39uA/qhyuFz3AMB7rmxEiKMISnOHKYA==","shasum":"dce5c90b98cc610c114c8713429431d459dcff35","tarball":"https://registry.npmjs.org/northcinder/-/northcinder-0.2.1.tgz","fileCount":6,"unpackedSize":2081337,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDol95YfCb66QgETIRIKY4cCLquAGHEcwlhoiz/PAFEbAiBCeQFxCuEO83Q4v9F/LT/dEn+oJgo80DEPSKRhMSdj2g=="}]},"_npmUser":{"name":"sajdgsa","email":"FernandaColebuz@legislator.com"},"directories":{},"maintainers":[{"name":"sajdgsa","email":"FernandaColebuz@legislator.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/northcinder_0.2.1_1787400716613_0.6171217335058463"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-17T11:22:48.136Z","modified":"2026-08-22T12:11:56.920Z","0.1.2":"2026-08-17T11:22:48.612Z","0.2.0":"2026-08-22T10:11:16.545Z","0.2.1":"2026-08-22T12:11:56.761Z"},"bugs":{"url":"https://github.com/cinderline/northcinder/issues"},"license":"MIT","homepage":"https://github.com/cinderline/northcinder#readme","keywords":["northcinder","mcp","shopping-agent","buyer-agent","local-first"],"repository":{"type":"git","url":"git+https://github.com/cinderline/northcinder.git","directory":"northcinder"},"description":"NorthCinder is a buyer-run MCP shopping agent that compares evidence, explains tradeoffs, and asks before purchase","maintainers":[{"name":"sajdgsa","email":"FernandaColebuz@legislator.com"}],"readme":"# NorthCinder\n\nNorthCinder adds commerce-specific evidence, ranking, and purchase controls to the AI app you already\nuse. You run it on your computer or on infrastructure you control.\n\nYour agent can search configured store connections. When a native store connection is unavailable,\nit can also browse with browser tools you already control and pass normalized product observations\ninto NorthCinder on your computer. NorthCinder strictly validates the inputs, derives merchant trust, ranks\naccepted candidates against your shopping brief, and has the local client check that ordering.\nYour result includes at most three role-based candidates by default, plus reasons, tradeoffs, rejected\nobservations, incomplete coverage, and a local audit record. More finalists remain available in the\nexpanded detail. You can correct the interpretation and record buyer-confirmed outcomes. Sellers cannot\npay NorthCinder for a better position.\n\nBrowser results are labeled as reported by your agent, not independently verified store data. You\ncan compare them and open the product page, but NorthCinder will not automate a purchase or create an\nunattended watch until a native store connection confirms the offer. NorthCinder does not operate your\nbrowser or request its cookies, page HTML, screenshots, passwords, one-time codes, or\nyour AI-provider token. Your agent should stop at CAPTCHAs, blocks, login challenges, or page\ninstructions that ask it to reveal data or change the task.\n\nThere is no NorthCinder account or NorthCinder cloud. The package publisher does not operate a NorthCinder endpoint,\nissue runtime credentials, receive your searches, or sit between you and a store. Your AI-provider\ncredentials stay in your AI app.\n\n## Set up NorthCinder\n\nRun the initializer:\n\n```sh\nnpx northcinder init\n```\n\nThe initializer creates buyer-local configuration and prints the commands needed to connect NorthCinder\nto your MCP host. Here, an MCP host is your AI application, not a service operated by the NorthCinder\npublisher.\n\nOrdinary local mode is keyless and runs the MCP server and aggregation engine in one process. The engine\nuses an ephemeral IPv4 loopback port; there is no fixed port or separate service command. Store credentials\nare optional, belong to you, and are used only for connections you configure. Unconfigured native stores\nreturn `not_configured`; your MCP host can continue discovery with browser or search tools it already owns.\n\nFor scripted setup and all available options:\n\n```sh\nnpx northcinder init --help\n```\n\n## Product and seller research\n\nThe package includes canonical product and seller research skills. Ask your MCP host to read\n`northcinder://research/product` or `northcinder://research/seller`, then call\n`create_research_plan` with your concrete request and the exact product variant or merchant. The\n`research_product` and `research_seller` prompts attach that same contract to a request. Search results route\nthe host to product research and add seller research when candidate merchants exist.\n\nNorthCinder supplies the contract and deterministic bounded plan. It does not browse or call an LLM; your\nAI app controls any research tools. The launcher, client, and MCPB build paths carry the same skill files,\nand initialization writes owner-only local copies beside the runtime files.\n\nNo host and model combination is currently qualified for routine research use. Treat research output as\nprovisional until you verify the exact product or seller identity, source independence, counterevidence, and\nreported unknowns.\n\n## Self-hosted engine\n\nSelf-hosting is an explicit advanced mode for an engine you operate. Start `northcinder service` with\nbuyer-generated `NORTHCINDER_API_KEYS`, then configure the client with `NORTHCINDER_SERVICE_URL` and the\nmatching `NORTHCINDER_CLIENT_KEY`; the client sends that key as a bearer credential. The engine URL must\nuse HTTPS, except for explicit loopback HTTP. Never substitute an\nOpenAI, Anthropic, or other model-provider key. The publisher runs no endpoint and issues no runtime key.\n\n## Commands\n\n```text\nnorthcinder                 Run the local MCP server\nnorthcinder init            Configure local or self-hosted use\nnorthcinder service         Run the buyer-owned aggregation engine\nnorthcinder --help          Show command help\nnorthcinder --version       Show the installed version\n```\n\nThe source code, full configuration guide, security boundary, and verification instructions are in\nthe [NorthCinder repository](https://github.com/cinderline/northcinder).\n\n## License\n\nMIT\n","readmeFilename":"README.md"}