DEV Community

MapleBridge.io
MapleBridge.io

Posted on

Why supplier search needs intent schemas, not just directories

Why supplier search needs intent schemas, not just directories

I used to think supplier search was mostly a search problem.

The buyer needs a product. The platform has suppliers. So the job is to make the search better.

But the more I worked on sourcing workflows, the more I realized the hard part is not finding “a supplier.” It is understanding what kind of supplier actually fits the buyer’s situation.

A buyer rarely just needs:

USB-C charger supplier

They usually mean something closer to:

I need 300 to 500 units of a 65W USB-C charger for Canada. I care about certification path, Amazon FBA packaging, carton test details, and whether the supplier can handle a small first order.

Those two requests look similar in a keyword search box, but they are not the same problem.

Directories flatten the request

Most supplier directories flatten a sourcing brief into product keywords.

That is understandable. Directories were built around listings, categories, and search results.

But in real sourcing, the deciding details are often outside the product name:

  • MOQ
  • target market
  • certification readiness
  • packaging requirements
  • export experience
  • response quality
  • What still needs to be checked before the introduction

If those details are not represented clearly, the buyer still has to do the real matching manually.

That is why a long supplier list can feel productive but still waste a lot of time.

The useful unit is not a listing

For AI-assisted sourcing, I think the useful unit is not the supplier listing.

It is the intent.

The buyer has an intent. The supplier has a capability. The matching layer should compare those two things and explain the fit.

That sounds obvious, but it changes the data model.

Instead of storing the buyer request as one paragraph of text, I want to break it into fields like:

  • product category
  • quantity range
  • market
  • certification needs
  • sales channel
  • timeline
  • missing information
  • human review notes

The same idea applies to suppliers:

  • factory type
  • MOQ range
  • export markets
  • product categories
  • certification experience
  • packaging capability
  • proof readiness

Once both sides are structured, the matching result can be more honest.

Not just:

This supplier matches.

But:

This supplier looks plausible because MOQ, category, and export-market fit line up. Certification path needs checking. Packaging proof is missing.

That kind of explanation is much more useful than a confidence score by itself.

I do not think AI should hide the uncertainty

One mistake I see in AI product demos is that everything looks too clean.

The system gives an answer, and the answer feels final.

In sourcing, that is dangerous.

A supplier can look good on paper and still be the wrong fit. A buyer brief can sound clear but still miss important details. A match can be promising but still needs human review.

So, for this type of workflow, I would rather expose the uncertainty:

  • what matched
  • what did not match
  • what is missing
  • what should be checked before the next step

That is one reason I have been working on an open protocol layer for this instead of only treating it as a private product feature.

What I am documenting

I am separating the public contract layer from the live product.

The public layer can describe things like:

  • buyer intent schema
  • supplier capability structure
  • agent handoff protocol
  • match explanation format
  • connector boundaries
  • Review states

The private layer still stays private:

  • production app code
  • customer data
  • supplier records
  • ranking weights
  • prompts
  • crawler sources

That boundary matters. Open does not mean exposing the whole business. It means making the reusable structure understandable.

I am documenting that open side here:

My current view is simple:

Supplier search should not start with a list.

It should start with a clear buyer intent, a clear supplier capability profile, and a match explanation that a human can actually review.

Top comments (0)